Skip to content
This repository was archived by the owner on Jun 22, 2026. It is now read-only.

fix(blog): migrate from Docusaurus, eradicate custom hacks, and unify blog metadata#109

Merged
PythonWoods-Dev merged 17 commits into
mainfrom
refactor/v0.14.1-native-blog
Jun 21, 2026
Merged

fix(blog): migrate from Docusaurus, eradicate custom hacks, and unify blog metadata#109
PythonWoods-Dev merged 17 commits into
mainfrom
refactor/v0.14.1-native-blog

Conversation

@PythonWoods-Dev

Copy link
Copy Markdown
Contributor

This pull request completely modernizes the documentation portal for the v0.14.1 sprint, fully deprecating the legacy Docusaurus setup in favor of native MkDocs Material plugins and layout.

Changes

  • Docusaurus Eradication: Deleted obsolete developers/ .mdx files and stripped legacy blind-spot URLs (.zenzic.toml), successfully achieving Zero-DBT cleanly.
  • Native Blog Migration: Removed custom Jinja sidebar hacks (blog_post.html) and restored the native MkDocs blog layout to eliminate maintenance debt.
  • Blog Content Purification: Swept all 14 blog posts to replace legacy Docusaurus <!-- truncate --> tags with MkDocs <!-- more --> excerpts. Hardcoded titles and redundant author/date metadata within the article bodies have been purged.
  • Author Configuration: Fixed the author avatar URL resolution path in .authors.yml.
  • Release Automation: Delegated RELEASE.md version bumping completely to bump-my-version via just release.

Verification

  • uv run mkdocs build --strict completes cleanly.
  • Blog index correctly truncates all articles (index file size reduced).
  • zenzic check all --strict and zenzic score --stamp succeed natively.

…gin, and unify frontmatter

Signed-off-by: PythonWoods-Dev <gianluca.catalano@gmail.com>
…docs-material

Signed-off-by: PythonWoods-Dev <gianluca.catalano@gmail.com>
…ths, and restore blog nav

Signed-off-by: PythonWoods-Dev <gianluca.catalano@gmail.com>
…t metadata

Signed-off-by: PythonWoods-Dev <gianluca.catalano@gmail.com>
…nd purge hardcoded metadata

Signed-off-by: PythonWoods-Dev <gianluca.catalano@gmail.com>
Signed-off-by: PythonWoods-Dev <gianluca.catalano@gmail.com>
Signed-off-by: PythonWoods-Dev <gianluca.catalano@gmail.com>
Signed-off-by: PythonWoods-Dev <gianluca.catalano@gmail.com>
Signed-off-by: PythonWoods-Dev <gianluca.catalano@gmail.com>
…tion and usage guides

Signed-off-by: PythonWoods-Dev <gianluca.catalano@gmail.com>
…eals to deprecated ADRs

Signed-off-by: PythonWoods-Dev <gianluca.catalano@gmail.com>
Signed-off-by: PythonWoods-Dev <gianluca.catalano@gmail.com>
…nd test fixture

Signed-off-by: PythonWoods-Dev <gianluca.catalano@gmail.com>
… core version pinning

Signed-off-by: PythonWoods-Dev <gianluca.catalano@gmail.com>
…cosystem layers

Signed-off-by: PythonWoods-Dev <gianluca.catalano@gmail.com>
…ns to 0.14.1/v2.1.1

Signed-off-by: PythonWoods-Dev <gianluca.catalano@gmail.com>
The Exclusion Zone model extends beyond structural correctness. A codebase or documentation suite that contains stale brand identifiers carries a different kind of debt: **narrative debt**. A page that still refers to a codename contradicts the contract it is trying to document.

Zenzic addresses this through the [`[governance]`](../reference/configuration-reference.md) configuration block and the [Z601 BRAND_OBSOLESCENCE](../reference/finding-codes.md#z601) finding. Format-aware, per-line suppression is available for intentional historical references using the appropriate comment syntax for the file type (`.md` vs. `.mdx`).
Zenzic addresses this through the [`[governance]`](../reference/configuration-reference.md) configuration block and the [Z601 BRAND_OBSOLESCENCE](../reference/finding-codes.md#z601) finding. Format-aware, per-line suppression is available for intentional historical references using the appropriate comment syntax for the file type (`.md` vs. `.md`).
Signed-off-by: PythonWoods-Dev <gianluca.catalano@gmail.com>
@PythonWoods-Dev PythonWoods-Dev force-pushed the refactor/v0.14.1-native-blog branch from 1ce1e09 to aa4aa1b Compare June 21, 2026 14:49
@PythonWoods-Dev PythonWoods-Dev merged commit 36dfa32 into main Jun 21, 2026
8 checks passed
@PythonWoods-Dev PythonWoods-Dev deleted the refactor/v0.14.1-native-blog branch June 21, 2026 14:52
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants