summaryrefslogtreecommitdiff
path: root/docs/intro/reusable-apps.txt
diff options
context:
space:
mode:
authorAymeric Augustin <aymeric.augustin@m4x.org>2013-12-24 16:28:31 +0100
committerAymeric Augustin <aymeric.augustin@m4x.org>2013-12-24 17:20:11 +0100
commit9b8192ce5101b622dbbae61f5ce784cd3e144a4d (patch)
treeb561542c9e074a2212cbcc8790a8b73b7f780b33 /docs/intro/reusable-apps.txt
parentf326720a7363f305a6767d71fc3a8db2dcb05c0e (diff)
Updated a few doc paragraphs following the app-loading refactor.
Diffstat (limited to 'docs/intro/reusable-apps.txt')
-rw-r--r--docs/intro/reusable-apps.txt16
1 files changed, 8 insertions, 8 deletions
diff --git a/docs/intro/reusable-apps.txt b/docs/intro/reusable-apps.txt
index 8959aae06a..4c6e2173db 100644
--- a/docs/intro/reusable-apps.txt
+++ b/docs/intro/reusable-apps.txt
@@ -42,9 +42,10 @@ projects and ready to publish for others to install and use.
bar``. For a directory (like ``polls``) to form a package, it must contain
a special file ``__init__.py``, even if this file is empty.
- A Django *app* is just a Python package that is specifically intended for
- use in a Django project. An app may also use common Django conventions,
- such as having a ``models.py`` file.
+ A Django *application* is just a Python package that is specifically
+ intended for use in a Django project. An application may use common Django
+ conventions, such as having ``models``, ``tests``, ``urls``, and ``views``
+ submodules.
Later on we use the term *packaging* to describe the process of making a
Python package easy for others to install. It can be a little confusing, we
@@ -128,11 +129,10 @@ 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
- </ref/contrib/index>`, for example ``auth``, ``admin`` or
+ Application labels (that is, the final part of the dotted path to
+ application packages) *must* be unique in :setting:`INSTALLED_APPS`.
+ Avoid using the same label as any of the Django :doc:`contrib packages
+ </ref/contrib/index>`, for example ``auth``, ``admin``, or
``messages``.
2. Move the ``polls`` directory into the ``django-polls`` directory.