diff options
| author | Aymeric Augustin <aymeric.augustin@m4x.org> | 2013-12-24 16:28:31 +0100 |
|---|---|---|
| committer | Aymeric Augustin <aymeric.augustin@m4x.org> | 2013-12-24 17:20:11 +0100 |
| commit | 9b8192ce5101b622dbbae61f5ce784cd3e144a4d (patch) | |
| tree | b561542c9e074a2212cbcc8790a8b73b7f780b33 /docs/intro/reusable-apps.txt | |
| parent | f326720a7363f305a6767d71fc3a8db2dcb05c0e (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.txt | 16 |
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. |
