Improve the output of the API docs.
Review Request #4535 — Created Sept. 6, 2013 and submitted
Improve the output of the API docs.
The API docs need a lot of work, and this is one step in that direction.
We now longer show sample XML payloads. While they work, it's preferable
that people just use JSON, so advertise that instead. This has the
benefit of lengthening some very large API doc pages.The examples now have a sample curl command line for getting the
resource. It also shows the headers that come back.The description of the resource is now at the top, before the other
details (like URL, child resources, etc.)Some bullet points have been removed where they just added clutter.
There are some fixes for table layouts. Mostly, this is dealing with
adding CSS classes, which will work with stylesheet changes for the RB
website.
Browsed through a bunch of docs. Looked at the new style and compared
to the old.
Description | From | Last Updated |
---|---|---|
Instead of having a border around all edges of the headers, can we just have a bottom border? |
david |
-
This is a review from Review Bot.
Tool: Pyflakes
Processed Files:
reviewboard/webapi/resources/filediff.py
docs/manual/_ext/webapidocs.py
Ignored Files:
- Change Summary:
-
Moved the description to the top, above the details table.
- Description:
-
Improve the output of the API docs.
The API docs need a lot of work, and this is one step in that direction.
We now longer show sample XML payloads. While they work, it's preferable
that people just use JSON, so advertise that instead. This has the benefit of lengthening some very large API doc pages. The examples now have a sample curl command line for getting the
resource. It also shows the headers that come back. + The description of the resource is now at the top, before the other
+ details (like URL, child resources, etc.) + + Some bullet points have been removed where they just added clutter.
+ There are some fixes for table layouts. Mostly, this is dealing with
adding CSS classes, which will work with stylesheet changes for the RB website. - Diff:
-
Revision 2 (+57 -27)
- Removed Files:
- Added Files:
-
This is a review from Review Bot.
Tool: PEP8 Style Checker
Processed Files:
reviewboard/webapi/resources/filediff.py
docs/manual/_ext/webapidocs.py
Ignored Files:
-
This is a review from Review Bot.
Tool: Pyflakes
Processed Files:
reviewboard/webapi/resources/filediff.py
docs/manual/_ext/webapidocs.py
Ignored Files: