Comment by N1H1L

Why not? I maintain markdown files explaining everything (this is committed). Also the Python code is typed and has detailed numpydoc docstrings.