Fix a handful of failures and regressions in our docs.
Review Request #9238 — Created Oct. 3, 2017 and submitted
The documentation no longer built, due to a series of missing files and
fixtures, incorrect metadata, and bad references.This change fixes all that by:
- Adding fixtures for issue verification state, OAuth2 apps/tokens, and
user-based file attachments - Adding missing API error and resource doc files
- Adding missing terms to the glossary
- Fixing metadata issues in new API resources
- Fixing the fixture dump script to include the new apps
- Fixing syntax errors in docstrings
- Fixing anchor names
It also fixes some bad filenames generated for the OAuth2 resources. The
uncamelcasing tried using "o-auth" instead of "oauth" in the filenames.
To fix this, support has been added for allowing names to be remapped as
needed in the config file.
Built the docs. There were still a couple of errors, but they're bigger
tasks that we've lived with until now. All the major ones preventing doc
building or cross-referencing are now gone.
- Change Summary:
-
Added some missing files to the change.
- Commit:
-
67963bc505cc8aceb5d605e7b997e66a35bbb35da2de0f322fe70ef7c322d9912162297d485e5bd9
- Diff:
-
Revision 2 (+365 -111)
Checks run (2 succeeded)
flake8
passed.
JSHint
passed.
- Change Summary:
-
- Removed an unnecessary
except ImportError: raise
- Split the list of app names in
dumpdata.sh
to one per line.
- Removed an unnecessary
- Commit:
-
a2de0f322fe70ef7c322d9912162297d485e5bd9019dca455fe46bd2dfbfda7452e90624cd5a121d
- Diff:
-
Revision 3 (+376 -112)
Checks run (2 succeeded)
flake8
passed.
JSHint
passed.