From 07514be580c00650dd4c2bb6c520ef5929b5e72b Mon Sep 17 00:00:00 2001 From: Daniel Roy Greenfeld Date: Sat, 16 Jan 2016 10:40:32 -0800 Subject: [PATCH] Fixes #345 explain need for django.contrib.sites --- CHANGELOG.md | 7 ++++--- docs/faq.rst | 10 ++++++++++ 2 files changed, 14 insertions(+), 3 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index f7a1867a..2f88a07d 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -2,12 +2,13 @@ All enhancements and patches to cookiecutter-django will be documented in this file. This project adheres to [Semantic Versioning](http://semver.org/). -## [2016-1-13] -### Changed -- Update setup.py version to 1.9.1 to match Django version. (@Collederas) +## [2016-1-16] +### Add explanation for having `django.contrib.sites`. (@pydanny) + ## [2016-1-13] ### Changed +- Update setup.py version to 1.9.1 to match Django version. (@Collederas) - Require Wheel 0.26.0. Needed to install certain packages on CPython 3.5+ like Pillow and psycopg2 (@audreyr) ## [2016-1-9] diff --git a/docs/faq.rst b/docs/faq.rst index 9ef54657..88e7fc2b 100644 --- a/docs/faq.rst +++ b/docs/faq.rst @@ -3,6 +3,16 @@ FAQ .. index:: FAQ, 12-Factor App +Why is there a django.contrib.sites directory in cookiecutter-django? +--------------------------------------------------------------------- + +It is there to add a migration so you don't have to manually change the ``sites.Site`` record from ``example.com`` to whatever your domain is. Instead, your ``{{cookiecutter.domain_name}}`` and {{cookiecutter.project_name}} value is placed by **Cookiecutter** in the domain and name fields respectively. + +See `0002_set_site_domain_and_name.py`_. + +.. _`0002_set_site_domain_and_name.py`: https://github.com/pydanny/cookiecutter-django/blob/master/%7B%7Bcookiecutter.repo_name%7D%7D/%7B%7Bcookiecutter.repo_name%7D%7D/contrib/sites/migrations/0002_set_site_domain_and_name.py + + Why aren't you using just one configuration file (12-Factor App) ----------------------------------------------------------------------