Webinar | January 22, 2021

3 learnings from our documentation workshop

Last week friday we held our first workshop by our documentation expert Daniele. Here's what we learned about software documentation. 

5 minutes read

First of all, we would like to thank you for the great interest in our first workshop led by the django CMS Association. We had over 20 participants and there were lively discussions among the attendees. Many thanks to Daniele Procida, who held the workshop and rightly received a lot of positive feedback for his presentation and the exercises that followed.

The picture above summarizes well the quintessence of the workshop. The basis of the framework for documentation presented by Danieles offers the division into 4 quadrants: Tutorials, How-Tos, Explanation and Reference. The distinct functions of these four different components of documentation were discovered by the participants themselves through their contribution to a collaborative exercise, in which they had to lend a hand ("Write a documentation (Tutorials, How-To, Explanation & Reference) about coffee").

If you are interested in the lecture and want to learn more about the framework, please watch this video:

Link: https://youtu.be/qC1OYK5oqDo

3 Learnings for the django CMS documentation

  1. Completely rewrite the tutorials

Our tutorials need to be enriched with up-to-date code, following best practices for django CMS, and with simpler, quicker results for the user.

  1. Bring documentation up to date with code

3. Removal of repetitive material

There is a lot of material that could profitably be jettisoned from right across the documentation, especially the rather repetitive material concerned with governance/community/contributing

To sum it up: Reduce, Simplify, Rationalise and Repeat

As you can see, there is a lot for us to do. If you feel like helping us out, join the "Documentation" working group and improve the django CMS documentation together with us.

Just write a short email to [email protected] and let him guide you through the process.

Mike Barrett

Article

The next chapter of django CMS starts with our members, past, present and future.

Mike Barrett, elected President of the django CMS Association for 2026 to 2028, thanks Mario Colombo and Joel Burch and sets out three priorities: a more valuable membership, an easier choice for agencies, and meeting in person at DjangoCon Europe.

Article

Hunting Down Quadratic Loops in django CMS

How PR #8913 removed quadratic work from django CMS menus, plugins, and page permissions: a permission-heavy menu on a 4,000-page site went from 11.7 seconds to 105 ms.

Article

One operation, three interfaces: a service architecture for django CMS

How shared content operations could support editors, REST integrations, and AI tools.