The API reference documentation describes the library interfaces, e.g. inputs, outputs,

and expected behavior. Most of the API documentation is written in docstrings. These are

comment blocks in source code that explain how the code works. All new or edited

comment blocks in source code that explain how the code works. All

docstrings should conform to the `numpydoc docstring guide`_. Much of theReST_ syntax

discussed above (:ref:`writing-rest-pages`) can be used for links and references.