About
Our publisher is a small open-source team that keeps its release notes and incident reports on its own site: two or three people who maintain a tool in their evenings, publish a release every few weeks and write up every outage, the embarrassing ones included.
Their readers run the tool. Before an upgrade they want to know what breaks and which line to change. When something is down they want the timeline and the fix, and they check the version before they trust a word.
Logbuch is built for that. Choose the Changelog template and start the title with the version, v0.9.0: Checks from two places, and the version becomes a mark above the title, with the release to upgrade from beside it. A red callout becomes the breaking change, and H2 sections named Added, Changed, Deprecated, Removed, Fixed and Security get their labels and counts. The Incident template turns a list whose items start with a time into a timeline, and internal tags such as #monitoring or #resolved and #minor, #major or #critical set its status and severity.
Pegel, Hanne Voss, David Osei and the county of Nordtal are invented, and so are the outages.
How every part of a post looks is in the style guide.