I am creating a Python package I have the working code but I have not yet document nor tested it Documentation can take any number of format, but HTML pages are the exected format Python has doc strings at the start of packages/modules/classes/function/methods/etc --------------------------------------------- getting start creating Python docs 1) install Sphinx 2) run sphinx-quickstart this will generate the index.rst and a makefile 2) run sphinx-api on my package this will generate *.rst files for my modules 3) edit the rst files to add markdown 4) make html to generate the doc pages optionally I can add sphnix extenshions for... spell check autodoc (generate doc trees) etc