Documentation news 2020

Hypermodern Python Chapter 5: Documentation (2020-01-29) by

In this fifth installment of the Hypermodern Python series, I’m going to discuss how to add documentation to your project.

In the previous chapter, we discussed how to add type annotations and type checking. (If you start reading here, you can also download the code for the previous chapter.)

Sphinx documentation is commonly written using reStructuredText (reST), although Markdown is also supported.

reStructuredText may not be as lightweight as Markdown, but its expressiveness and extensibility, among other reasons, make it more suitable for writing technical documentation.