diff --git a/docs/ref/contrib/admin/index.txt b/docs/ref/contrib/admin/index.txt index e1facc2a5a9..394b5af5db5 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 ========