[ckan-dev] pylons.app_globals vs pylons.config

Mon Apr 29 16:08:39 UTC 2013

We'll soon be merging this pull request from Vitor into master and 2.0:

https://github.com/okfn/ckan/pull/833

which is a heroic effort to document all CKAN's undocumented config
options.

It's a huge improvement but unfortunately, I think there's still a lot
of work to be done here:

- options with docstrings that really don't explain what the option does
- options that don't actually work as documented
- options that should be marked as deprecated
- options that should be marked as beta or experimental
- options that should be renamed to group related options together
- options that are still missing from these docs, despite Vitor's
  efforts to find them all

If everyone could have a quick scan of the new file:

https://github.com/okfn/ckan/blob/31a0c22a460a45593fb45868d8026de986889756/doc/configuration.rst

and let us know about any undocumented or incorrectly documented options
you see, that would be a help.

Needless to say, if you add, remove or change a config option in the
future, please document it!