Skip to article frontmatterSkip to article content
Site not loading correctly?

This may be due to an incorrect BASE_URL configuration. See the MyST Documentation for reference.

Things on this page are fragmentary and immature notes/thoughts of the author. Please read with your own judgement!

Tips and Traps

  1. I personal prefer the sphnix style as it is concise and work well with type annotation.

  2. Improperly escaped \n in docstring causes darglint fail to parse the docstring.

VSCode Docstring Sphinx

References

What is the standard Python docstring format? [closed]

Documenting Python Code: A Complete Guide

The docstrings main formats

Documenting Python

Docstrings in Python