Python code can include documentation right inside its source code. The default way of doing so relies on docstrings, which are defined in a triple quote format. While the value of documentation is well… documented, it seems all too common to not document code sufficiently. Let[he]#039[/he]s walk through a scenario on the power of great documentation.

Source: LXer – How to document Python code with Sphinx