Django Friday Tips: Admin Docs

While the admin is a well known and very useful app for your projects, Django also includes another admin package that isn’t as popular (at least I never seen it being heavily used) but that can also be quite handy.

I’m talking about the admindocs app. What it does is to provide documentation for the main components of your project in the Django administration itself.

It takes the existing documentation provided in the code to developers and exposes it to users that have the is_staff flag enabled.

This is what they see:

A view of the main page of the generated docs. Checking documentation for existing views. Checking a model reference.

I can see this being very helpful for small websites that are operated by teams of “non-developers” or even for people providing support to customers. At least when a dedicated and more mature solution for documentation is not available.

To install you just have to:

• Install the docutils package.
• Add django.contrib.admindocs to the installed apps.
• Add path('admin/doc/', include('django.contrib.admindocs.urls')) to the URLs.
• Document your code with “docstrings” and “help_text” attributes.

More details documentation can be found here. And for today, this is it.

Leave a Reply Cancel reply

Your email address will not be published. Required fields are marked *

Comment *

Name *

Email *

Website