From b954ad0640e1f246f60f31a07a567274c2f20751 Mon Sep 17 00:00:00 2001 From: Tim Graham Date: Mon, 8 Feb 2016 16:46:40 -0500 Subject: [PATCH] Added intended use in the admin's introduction. --- docs/ref/contrib/admin/index.txt | 16 ++++++++++++---- 1 file 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 ========