Python docstrings are special strings ... as well as any relevant examples, references, or notes. A docstring should be clear and concise, using simple and precise language that avoids ambiguity ...

Names should be descriptive, concise, and follow the Python conventions for naming styles. For example ... and classes. Write clear comments to explain complex logic or algorithms.