diff --git a/docs/ref/contrib/admin/admindocs.txt b/docs/ref/contrib/admin/admindocs.txt index c5386c5b2f9..6e2ca745cf0 100644 --- a/docs/ref/contrib/admin/admindocs.txt +++ b/docs/ref/contrib/admin/admindocs.txt @@ -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 :mod:`Django admin `. -In addition to providing offline documentation for all template tags and -template filters that ship with Django, you may utilize admindocs to quickly -document your own code. +You may, to some extent, utilize :mod:`~django.contrib.admindocs` to quickly +document your own code. This has limited usage, however, as the app is +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 `. Overview ========