This page list the best practices when documenting a project on Notion.

Documentation versioning

A same project can have several versions and each versions should have their own documentation.

But this is difficult to do in Notion, because even if pages have history, there is no easy way to view the page at a specific point in history.

Also, when auto-documenting a Notion page with docution, the process modify the page itself, and so it's not easy to maintain several versions of the same documentation.

To fix this problem, one solution is to use templates.

What I usually do is the following : Create a master page, where all versions of the documentation will be listed. Then create a template here, and write the documentation inside this template.

This is fine, because templates can contains subpages, so we can create complex documents.

Then, whenever I want to release a version of the documentation, I create a page from this template, name it right (with the version number), and auto-document it with docution !