Вообщем буду краток ;)
Для документирования питоньих проектов очень удобно использовать Sphinx. Это всем известно. А если не известно, то и Python, и Django документированы именно им.
На GitHub'е есть возможность размещения HTML страниц проекта и последующего доступа к ним по адресу: http://username.github.com/repo_name/
.
Само собой разумеется, было бы очень неплохо подружить их. И посему я на коленке написал следующую Makefile
-команду:
project=YOUR_PROJECT_NAME
docs_dir=$(TMPDIR)/$(project)-docs
ghdocs:
rm -rf $(docs_dir)
$(MAKE) -C docs html
cp -r docs/_build/html $(docs_dir)
mv $(docs_dir)/_static $(docs_dir)/static
mv $(docs_dir)/_sources $(docs_dir)/sources
perl -pi -e "s/_sources/sources