Pylons/pyramid — Issue #313: Add minimal Sphinx config in basic scaffold
Author: merwok
Created: 2011-10-09 08:44:07+00:00
State: open

In the time of Pylons, when one created an app template with paster, there was a docs directory with an index.txt file suggesting to write docs. I think it was a good idea. For Pyramid, the starter scaffold (if I’m translating the terms right) could include a basic Sphinx configuration, reusing the project’s name, version, author, etc. as values in conf.py (and thus removing the need to use sphinx-quickstart).

On IRC, Chris was not opposed to this idea but not much supportive either. I can propose a patch, but not right now. Do other developers think this would be a good idea?