Skip to content

Multidoc

Multidoc is a tool for purposed towards improving maintainability and consistency of docstrings in software that is available across multiple programming languages, with fixed language equivalent APIs.

`list` **Nomenclature** ^^^ - **Application Programming Interface (API)**: An interface that defines interactions between multiple software applications or mixed hardware-software intermediaries. - **YAML**: (recursive acronym for "YAML Ain't Markup Language") A human-readable data-serialization language. - **Jinja2**: Jinja is a modern and designer-friendly templating language for Python. It is fast, widely used and secure.

Functions

https://numpydoc.readthedocs.io/en/latest/format.html#sections

Classes

Use the same sections as outlined above (all except Returns are applicable). The constructor (__init__) should also be documented here, the Parameters section of the docstring details the constructor’s parameters.

Constants

1. summary
2. extended summary (optional)
3. see also (optional)
4. references (optional)
5. examples (optional)

Modules

1. summary
2. extended summary
3. routine listings
4. see also
5. notes
6. references
7. examples