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