Go to file
Spencer Olson 3792afc12e api docs: add deprecation functionality + documentation
Adds the @deprecated_method, @deprecated_argument, and
@deprecated_response_field tags for API documentation. Also adds the
'deprecated', 'deprecation_notice', 'deprecation_effective', and
'deprecation_description' attributes for the API models and their
properties.

closes GRADE-1450

Test Plan:
1. Read the deprecation_README provided in this commit and verify you
   can deprecate methods, arguments, response fields, models, and
   model attributes. This verificiation process should include:
   - Verifying the `rake doc:api` command throws an error when invalid
     and/or missing parameters are used for the deprecation tags
   - Verifying the deprecations show up in the generated documentation
     (located at public/doc/api/index.html) after running
     `rake doc:api`.
2. Verify the @argument, @response_field, and @model tags still work
   and generate appropriate documentation when running `rake doc:api`

Change-Id: If6c2b0ee9fccbbd202990d8835c6266017e2dfa5
Reviewed-on: https://gerrit.instructure.com/138581
Reviewed-by: Gary Mei <gmei@instructure.com>
Reviewed-by: Derek Bender <djbender@instructure.com>
QA-Review: Gary Mei <gmei@instructure.com>
Tested-by: Jenkins
Product-Review: Simon Williams <simon@instructure.com>
2018-08-16 18:27:55 +00:00
.github Add config for github bot to close old issues 2018-07-19 17:16:13 +00:00
Gemfile.d rails 5.2: bump rails 2018-08-13 15:18:04 +00:00
app move PlannerController#index onto slave 2018-08-16 15:44:33 +00:00
bin spec: Add git SHA to pact file consumer version. 2018-07-07 00:01:58 +00:00
build Upgrade yarn from 1.7.0 to 1.9.4 2018-08-14 16:11:54 +00:00
client_apps Use yarn workspaces 2018-06-04 20:02:02 +00:00
config fix creating new shards from scratch 2018-08-15 23:33:46 +00:00
db/migrate add index for canvadoc_id to canvadocs_submissions 2018-08-16 15:37:38 +00:00
doc api docs: add deprecation functionality + documentation 2018-08-16 18:27:55 +00:00
docker-compose Add dc config to jwk set_keys 2018-08-10 17:44:48 +00:00
frontend_build Add a couple more things to vendor bundle 2018-07-06 16:05:25 +00:00
gems moar preloads 2018-08-10 17:28:38 +00:00
jest jest: mute instUI warning about needing dir attr 2018-06-13 16:14:37 +00:00
lib Add anonymous grading substitution 2018-08-16 15:40:27 +00:00
packages Keep discussions without replies from showing new activity dot 2018-08-14 21:03:22 +00:00
pact spec: wiki page spec 2018-08-03 18:26:06 +00:00
public Keep section synced between SG/new gradebook 2018-08-08 22:16:17 +00:00
script A script to just update instUI 2018-08-15 20:21:10 +00:00
spec api docs: add deprecation functionality + documentation 2018-08-16 18:27:55 +00:00
.babelrc add babel-plugin-transform-runtime for smaller JS 2017-10-12 14:35:46 +00:00
.bowerrc introduced bower to manage js dependencies 2013-12-13 17:45:57 +00:00
.codeclimate.yml disable ESLint in code climate 2017-02-14 17:47:39 +00:00
.dockerignore fix canvas-planner docker build process 2018-04-17 14:44:18 +00:00
.editorconfig Add EditorConfig configuration file to help maintain code style 2016-11-15 20:08:55 +00:00
.eslintignore ignore AmbiguousBlockAssociation for specs 2018-02-12 18:37:09 +00:00
.eslintrc.js Add eslint rule for jsx accessibility linting 2018-07-02 16:48:25 +00:00
.gitignore Add a way to generate better js coverage 2018-07-17 14:19:03 +00:00
.i18nignore bump rails 3 to github branch for ruby 2.2 compatibility 2015-02-18 22:55:20 +00:00
.i18nrc upgrade to node 6 2016-08-09 23:37:07 +00:00
.jshintrc make jslint settings more sane 2012-08-17 11:04:40 -06:00
.npmrc fix brand config previewing and skipping 2015-10-27 16:16:15 +00:00
.nvmrc Use node 8.10.0 instead of 8.9.4 2018-03-09 18:56:22 +00:00
.prettierrc Add .prettierrc so it matches our existing code 2017-11-03 16:21:50 +00:00
.rubocop.yml remove curly brace block warning in specs 2018-08-09 22:07:06 +00:00
.selinimumignore Revert and bring InstIcons into Canvas 2016-11-29 20:52:54 +00:00
.stylelintrc stylelint, refs SD-1603 2016-10-25 00:21:16 +00:00
.travis.yml more travis builds 2014-02-10 16:23:19 +00:00
CONTRIBUTING.md Add CLA FAQ from legal 2018-01-22 16:41:44 -05:00
COPYRIGHT Initial commit. 2011-01-31 18:57:29 -07:00
Dockerfile Upgrade yarn from 1.7.0 to 1.9.4 2018-08-14 16:11:54 +00:00
Dockerfile-production Upgrade yarn from 1.7.0 to 1.9.4 2018-08-14 16:11:54 +00:00
Gemfile allow choosing rails 5.1 via consul 2017-10-11 19:13:02 +00:00
LICENSE Initial commit. 2011-01-31 18:57:29 -07:00
README.md Update README.md since Canvas is still modern 2016-12-15 03:18:28 +00:00
Rakefile remove dead parallelized specs task 2016-11-10 21:41:08 +00:00
bower.json spec: remove ember-qunit 2018-07-13 14:24:41 +00:00
code_of_conduct.md contributor code of conduct 2014-12-23 18:13:59 +00:00
config.ru remove extra logging to debug Passenger connection orphan issue 2017-07-14 16:27:03 +00:00
docker-compose.jenkins.yml Rename docker-compose.test.yml 2017-05-17 18:51:53 +00:00
docker-compose.override.yml upgrade yarn to 1.6.0 2018-04-19 20:31:06 +00:00
docker-compose.yml Use redis:alpine 2017-07-31 22:31:40 +00:00
gulpfile.js polyfill es6.number for IE11 2018-06-12 15:01:24 +00:00
issue_template.md Make issue template disclaimer a comment 2018-05-01 15:00:27 +00:00
jest.config.js Add a way to generate better js coverage 2018-07-17 14:19:03 +00:00
karma.conf.js Add a way to generate better js coverage 2018-07-17 14:19:03 +00:00
package.json A script to just update instUI 2018-08-15 20:21:10 +00:00
schema.graphql graphql: make assignments_connection_interface 2018-07-06 23:00:22 +00:00
webpack.config.js don't pass frontend build files through babel 2016-11-08 20:29:29 +00:00
webpack.production.config.js a couple uglifyJS settings to make prod debugging easier 2018-05-03 19:52:15 +00:00
webpack.test.config.js Add release tracking and source map uploading to sentry 2018-06-15 19:40:36 +00:00
yarn.lock A script to just update instUI 2018-08-15 20:21:10 +00:00

README.md

Canvas LMS

Canvas is a modern, open-source LMS developed and maintained by Instructure Inc. It is released under the AGPLv3 license for use by anyone interested in learning more about or using learning management systems.

Please see our main wiki page for more information

Installation

Detailed instructions for installation and configuration of Canvas are provided on our wiki.