Ticket #7983: 7983.fields_doc.diff

django/django/docs/admin.txt

@@ -147 +147 @@
     ``django.utils.html.escape()`` to escape any HTML special
     characters.
 
+``fields``
+~~~~~~~~~~
+
+Use this option as an alternative to ``fieldsets`` if the layout does not matter and if
+you want to only show a subset of the available fields in the form. For example, you could
+define a simpler version of the admin form for the ``django.contrib.flatpages.FlatPage`` model
+as follows::
+
+    class FlatPageAdmin(admin.ModelAdmin):
+        fields = ('url', 'title', 'content')
+
+In the above example, only the fields 'url', 'title' and 'content' will be displayed, sequencially,
+in the form.
+
+Remark: this ``fields`` option should not be confused with the ``fields`` dictionary key that is used
+within the ``fieldsets`` option, as described in the previous section.
+
 ``filter_horizontal``
 ~~~~~~~~~~~~~~~~~~~~~