Arvados

Ensure all public classes, methods, and functions in the arvados.api module have docstrings in our style.

19818-api-pydoc @ e506be286860ea57065816465fd22c203b9b145a - developer-run-tests: #3839

Two commits. The first deprecates OrderedJsonModel. See the commit message for details.

The second adds the rest of the documentation. One thing I did as part of it is move all the deprecated stuff to the bottom of the module. pdoc renders things in definition order, so this means it appears at the bottom of the web documentation too. That seems like a nice thing to do for readers. If it sounds good to you too, I'll add it to our coding guidelines.

• All agreed upon points are implemented / addressed.
  • Yes
• Anything not implemented (discovered or discussed during work) has a follow-up story.
  • N/A
• Code is tested and passing, both automated and manual, what manual testing was done is described
  • See above - the Workbench integration test failure can't possibly be real
• Documentation has been updated.
  • Yes
• Behaves appropriately at the intended scale (describe intended scale).
  • N/A
• Considered backwards and forwards compatibility issues between client and server.
  • Yes, see first commit message
• Follows our coding standards and GUI style guidelines.
  • Yes

Applied in changeset arvados|c1bc5396fd54f376a11741cfb7ce420b5929a5a5.