Change Details
Changes
(-0, +284, 284)
ntation updates without exposing private Forgejo links, commit hashes, branches, or raw Git history.
The generator creates two kinds of pages:
| Generated file | Purpose |
| --- | --- |
| `docs/changelog.md` | Public index of documentation changes, newest first. |
| `docs/changelog/*.md` | One detail page per page change, including a sanitized diff against the previous version. |
## Supported frontmatter
Each documentation page can include metadata at the top of the file:
``
(-110, +217, 327)
tles` for titles that visitors might remember from older versions of the site.
## What changed text
The changelog uses the latest Git commit message that touched each page as the short "what changed" descript and detail pages
The changelog uses Git commit messages as the short "what changed" descriptions. Each committed page change gets its own generated detail page showing what was edited compared with the previous version.
Write documentation commit messages for readers, not just for developers. For example:
```tex
(-23, +47, 70)
Explains the Nginx reload step and fixes the published path.
The generator removes public URLs</span><span class="changelog-removed"> and commit-like hashes</span><span class="changelog-added">, commit-like hashes, and raw Git diff metadata</span><span class="changelog-context"> from the changelog output so private Forgejo details are not exposed.
## Regenerating manually
Ru</span>
</code></pre>
(-116, +182, 298)
<pre class="changelog-change-block"><code>
<span class="changelog-context">e repo root:
```bash
python3 scripts/generate_changelog.py
mkdocs build --clean
The generated page is written to `docs/changelog.md`. Do not edit that file by hand because the next generator run will replace itindex is written to `docs/changelog.md`, and generated detail pages are written to `docs/changelog/`. Do not edit those files by hand because the next generator run will replace them.
## Deployment
The server deploy workflow should run the generator after pulling the latest commi
What changed
implemented pages for each changelog
Page details
Page name: Changelog System
Page path: admin/changelog-system.md
Original writing date: 2026-07-08
Original published date: 2026-07-08
Most recent editing date: 2026-07-08
Title changed: No
Previous title: None