diff options
| author | Tim Graham <timograham@gmail.com> | 2016-02-08 16:46:40 -0500 |
|---|---|---|
| committer | Tim Graham <timograham@gmail.com> | 2016-02-18 08:50:22 -0500 |
| commit | b954ad0640e1f246f60f31a07a567274c2f20751 (patch) | |
| tree | f94afdfe0dbc9b723750e913637f3814519d9393 /docs | |
| parent | 70d3f81ca4ea7e1e1310e13ce0a633d7f920d45b (diff) | |
Added intended use in the admin's introduction.
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/ref/contrib/admin/index.txt | 16 |
1 files changed, 12 insertions, 4 deletions
diff --git a/docs/ref/contrib/admin/index.txt b/docs/ref/contrib/admin/index.txt index e1facc2a5a..394b5af5db 100644 --- a/docs/ref/contrib/admin/index.txt +++ b/docs/ref/contrib/admin/index.txt @@ -6,10 +6,18 @@ The Django admin site :synopsis: Django's admin site. One of the most powerful parts of Django is the automatic admin interface. It -reads metadata in your model to provide a powerful and production-ready -interface that content producers can immediately use to start adding content to -the site. In this document, we discuss how to activate, use and customize -Django's admin interface. +reads metadata from your models to provide a quick, model-centric interface +where trusted users can manage content on your site. The admin's recommended +use is limited to an organization's internal management tool. It's not intended +for building your entire front end around. + +The admin has many hooks for customization, but beware of trying to use those +hooks exclusively. If you need to provide a more process-centric interface +that abstracts away the implementation details of database tables and fields, +then it's probably time to write your own views. + +In this document we discuss how to activate, use, and customize Django's admin +interface. Overview ======== |