сейчас модно доку вести в
sphinx
писать можно в их собственной разметке
reStructuredText либо в
markDown
можно добивать плагинами
например с плагином nbsphinx оно кушает
.ipynb (jupiter-notebooks)
sphinx можно использовать и как self-hosted, а можно, совершенно нахаляву, все то же самое делать в облаке
readthedocs.io