Fixed #14633 - Organized settings reference docs #620

wants to merge 3 commits into


None yet
2 participants

timgraham commented Jan 5, 2013

Here's a rendered copy of the changes:

IANACD (not-a-core-dev), but, I have used a similar organization in my own Django projects in in the past and so I have some feedback here.

  1. Your breakdown is pretty good but it feels like "core" could use some more breakdown. At the very least I personally like "template" related settings to be broken out. Other candidates include: logging, caches, globalization (i18n/l10n), email, file uploads/media, storages, and security.
  2. I do think that such an organization should be reflected in the generated by startproject. However, they need not be alphabetized there. So, e.g., perhaps INSTALLED_APPS is one of the first things we would see there. Also, each block mirroring this doc could have a comment block pointing back to relevant doc for both the settings and related core Django app.

Yeah, I like that new topical breakdown!

@timgraham timgraham closed this Jan 12, 2013

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment