From 4f9590836ca679e4aef2627a71f4277ca4c80605 Mon Sep 17 00:00:00 2001 From: Alasdair Nicol Date: Thu, 5 Dec 2013 13:45:49 +0000 Subject: [PATCH] [1.6.x] Fixed #21562 -- Warned against using the same app name as a django contrib app. Thanks yourcelf for the report. Backport of 317fd13c7a from master --- docs/intro/reusable-apps.txt | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/docs/intro/reusable-apps.txt b/docs/intro/reusable-apps.txt index ba3b7fbbbb..73b9461408 100644 --- a/docs/intro/reusable-apps.txt +++ b/docs/intro/reusable-apps.txt @@ -128,6 +128,13 @@ this. For a small app like polls, this process isn't too difficult. This helps others looking for Django apps identify your app as Django specific. + The application names (that is, the final dotted part of the + path to the module containing ``models.py``) defined in + :setting:`INSTALLED_APPS` *must* be unique. Avoid using the + same name as any of the Django :doc:`contrib packages + `, for example ``auth``, ``admin`` or + ``messages``. + 2. Move the ``polls`` directory into the ``django-polls`` directory. 3. Create a file ``django-polls/README.rst`` with the following contents::