Add a tutorial to the docs

[jezdez]

trafficstars

This is basically related to #35, which showed that a guiding tutorial would help not making mistakes.

[ghost]

+1

I also have a question out on serverfault for some issues around the shell variables that describes my particular woes in more detail: http://serverfault.com/questions/547301/why-cant-django-configurations-pick-up-a-secret-key-environment-variable-from-a

[jezdez]

@Aviendha I'd appreciate if you'd open a ticket here with your issue for documentation purposes. Serverfault isn't great for this. Thanks

[ghost]

K. Sorry about that - I'm still figuring out social conventions.

I ended up figuring out the problem. Would it be better or worse to submit a pull request that changes the error message rather than requesting a change?

[jezdez]

@Aviendha No worries, thanks for giving feedback in the first place! Send whatever works for you and we can figure out the rest from there :)

[wldcordeiro]

:+1: I'm trying to figure out how to configure multiple databases with django-configurations and it's a bit more complicated than I expected a guide would be nice.

[bittner]

We should explain how to configure multiple databases, caches or search URLs directly in the URL-based values section of the documentation. This pops up regularly (see #97, #161, #170). Preferably, with solutions leveraging the powers of the modules django-configurations already depends on:

• DATABASES: https://github.com/jazzband/django-configurations/issues/97#issuecomment-90969736 -- dj_database_url.config()
• CACHES: https://github.com/jazzband/django-configurations/issues/170#issuecomment-288845763 -- django_cache_url.config()

The rest of this issue seems to be covered by the Quickstart and the Cookbook sections by now.