jabooth / menpo-archive

Old frozen version of Menpo, only kept for archival purposes.
github.com/menpo/menpo
Other
6 stars 2 forks source link

Sphinx Documentation #22

Closed jabooth closed 10 years ago

jabooth commented 11 years ago

We should have automatically generated Sphinx documentation for our code. For now, we will follow the basic Sphinx (reStructuredText) layout for docstrings. Handily, pycharm can help us out with this formatting for free. This PR requires three things:

1, A first stab of Sphinx documentation for the project

  1. A method to regenerate the documentation on demand
  2. A document in the wiki to lay out exactly how we should document our code.