mirrors/django
1
0
Fork 0
mirror of https://github.com/django/django.git synced 2025-10-17 22:07:29 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 4

Updated a few doc paragraphs following the app-loading refactor.

Browse source
This commit is contained in:
Aymeric Augustin 2013-12-24 16:28:31 +01:00
parent f326720a73
commit 9b8192ce51
3 changed files with 17 additions and 19 deletions
Download patch file Download diff file Expand all files Collapse all files

16
docs/intro/reusable-apps.txt
View file

@ -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.