cleaning up docs/conf.py

[Tshepang Lekhonkhobe]

I find the file overlong and messy. I would therefore like to get rid
of all commented-out unused options (those which just display a
default value). Is this acceptable?

[Tshepang Lekhonkhobe]

anyone?

[Domen Kožar]

I'd say it better to stay there, as it provides inline documentation for settings that you might turn on.

To clean it up, maybe split settings in two sections - configured and commented.

--
You received this message because you are subscribed to the Google Groups "pylons-devel" group.
To unsubscribe from this group and stop receiving emails from it, send an email to pylons-devel...@googlegroups.com.
To post to this group, send email to pylons...@googlegroups.com.
Visit this group at http://groups.google.com/group/pylons-devel?hl=en.
For more options, visit https://groups.google.com/groups/opt_out.
 
 

[Tshepang Lekhonkhobe]

Well, one can always add a link targetting Sphinx settings documentation:

    For a complete listing of available settings, see http://sphinx-doc.org/config.html.

An advantage with this approach is you get updated info, for example.