I use my documentation system to write about knowledge management and software development. This includes conceptual approaches or methodologies, as well as tools and technical implementations.

I am trying to create clusters around higher-level topics. This section about a "documentation system" is an example of such a cluster.

Within a cluster, I am migrating towards separate sections for explanations, tutorials, how-to guides, and reference documentation. This is based on the Diátaxis Framework, which is specifcally focused on technical documentation.

Since a lot of my documentation is tied to software development, I want to use a "docs as code" approach: this means that the documentation is written in plain text files, and stored in various version control repositories.

With the "docs as code" approach, the easiest way to publish the documentation is to use a static site generator. The publication process can be automated as part of the version control workflow.