innov
/
django1
1
0
Fork 0
Code Issues Pull Requests 1 Projects Releases Wiki Activity

Explained why admindocs omits model methods with arguments.

This commit is contained in:
Zan Anderle 2014-10-30 20:45:01 +01:00 committed by Tim Graham
parent 8f79c154ca
commit 9e3aaa5a46
1 changed files with 8 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

11
docs/ref/contrib/admin/admindocs.txt
View File

@ -12,9 +12,14 @@ docstrings of models, views, template tags, and template filters for any app in
:setting:`INSTALLED_APPS` and makes that documentation available from the :setting:`INSTALLED_APPS` and makes that documentation available from the
:mod:`Django admin <django.contrib.admin>`. :mod:`Django admin <django.contrib.admin>`.
In addition to providing offline documentation for all template tags and You may, to some extent, utilize :mod:`~django.contrib.admindocs` to quickly
template filters that ship with Django, you may utilize admindocs to quickly document your own code. This has limited usage, however, as the app is
document your own code. primarily intended for documenting templates, template tags, and filters.
For example, model methods that require arguments are purposefully omitted
from the documentation because they can't be invoked from templates. The app
can still be useful since it doesn't require you to write any extra
documentation (besides docstrings) and is conveniently available from the
:mod:`Django admin <django.contrib.admin>`.
Overview Overview
======== ========