Redo the index page for the API docs for better guidance/organization.

Review Request #9377 — Created Nov. 15, 2017 and submitted

Information

Review Board
release-3.0.x
0935a32...

Reviewers

The index page for the API documentation was nothing but a giant
toctree, which didn't really provide any guidance at all. This has been
replaced with a new index page that gives a brief overview of the API,
followed by sections on:

  • Getting started with the API (containing the overview, authentication,
    and glossary)
  • API bindings available (linking to the RBTools Python API docs)
  • Working with special data (currently consisting of rich text fields
    and, later, extra_data handling)
  • Available resources (linking to the resource tree and categories)
  • Errors (linking to the full list of errors)

It also gets rid of any mention of the old API 1.0 docs, which isn't
worth including anymore.

Checked for build and spelling errors.

Tested that the links pointed to the right places.

david
  1. Looks pretty good but this will need an update to include the oauth2 docs I just pushed.

  2. 
      
chipx86
david
  1. Ship It!
  2. 
      
chipx86
Review request changed
Status:
Completed
Change Summary:
Pushed to release-3.0.x (6ca6afd)