v0.15.0

🚀 Z603 Documentation, Typography Polish & Vaporware Purge

📚 Documentation Is Architecture (D.I.A.)

• Z603 Fixtures: Shipped the official tutorial, rule documentation, and reproducible interactive fixture for the newly introduced Z603 DEAD_SUPPRESSION finding.

💄 Typography & Aesthetic Polish

• Elegant Example Headers: Executed a massive typographic sweep across the entire Examples directory (29 pages). Raw, auto-generated headers (e.g., # Z104-file-not-found) have been restructured into an elegant, standard Title Case format (e.g., # Z104 — File Not Found), significantly improving visual hierarchy and readability. Redundant frontmatter titles have been stripped.

🧹 Vaporware Eradication

• Purged the ghost z602-i18n-parity.md tutorial and all its navigation references. Hosting tutorials for currently inactive diagnostic codes violates the strict Single Source of Truth architecture.
• Archived legacy v0.14.x changelogs.

v0.14.1 - The Great MkDocs Migration & Native Blog Overhaul

This patch release completes the architectural pivot of the Zenzic documentation portal, entirely deprecating Docusaurus and custom hacks in favor of the industry-standard MkDocs Material native blog plugin.

🧹 Chores & Cleanup

• Docusaurus Deprecation: Eradicated all remnant .mdx files and legacy blind-spot suppressions.
• Native Blog Architecture: Deleted the heavily-customized Jinja sidebar in favor of native MkDocs routing and layout components, greatly reducing maintenance technical debt.

📝 Documentation & UX

• Blog Truncation Standard: Migrated all historical blog posts to use standard MkDocs <!-- more --> excerpt tags, dramatically reducing the blog index file size and fixing visual overflow.
• Metadata Purification: Stripped all manually hardcoded dates, authors, and redundant H1 titles from blog article bodies.
• Avatar Fix: Repaired broken avatar image URLs inside the blog's .authors.yml.
• CSS Formatting: Centralized and correctly formatted overriding CSS for the site's layout.

What's Changed

• fix(blog): migrate from Docusaurus, eradicate custom hacks, and unify blog metadata by @PythonWoods-Dev in #109
• ci: migrate release and build workflows from zensical to mkdocs-material by @PythonWoods-Dev in #110

Full Changelog: v0.14.0...v0.14.1

What's Changed

• fix(blog): migrate from Docusaurus, eradicate custom hacks, and unify blog metadata by @PythonWoods-Dev in #109
• ci: migrate release and build workflows from zensical to mkdocs-material by @PythonWoods-Dev in #110
• docs(blog): migrate articles from mdx to standard md by @PythonWoods-Dev in #111

Full Changelog: v0.14.0...v0.14.1

v0.14.0

Zenzic Documentation v0.14.0

Aligned with Zenzic Core v0.14.0.

📖 New: Z506 MALFORMED_FRONTMATTER Gallery Page

Complete documentation for the new Z506 rule: live terminal output, examples of all
malformed delimiter variants, configuration guide, and suppression instructions.

📰 Blog UX Sprint v3

• Pagination: Blog index split to 10 posts per page with ← / → navigation links.
• Posts sidebar: Right panel on all blog post pages listing all 14 posts with
  active-post highlighting. Replaces the table of contents (TOC).
• Breadcrumbs: Manual Home › Blog › Title breadcrumb on every blog post with
  inline SVG home icon.
• Metadata bar: Date / authors / tags displayed after the H1 title, before the body.
  Pure Jinja2, zero JavaScript.
• Footer: Copyright notice now renders on all pages.
• Nav icons: Universal document icon added to all left-sidebar navigation links.

🗑️ I18N Eradication

Italian documentation fully removed. A Cloudflare Pages splat redirect /it/* → /:splat 301
preserves all legacy Italian URLs with zero 404s.

🐛 Fixed

• TOC right sidebar accent background on reference pages.
• Breadcrumb home icon selector (.md-path__item not .md-breadcrumb__item).

---

Full Changelog: CHANGELOG.md

Release v0.13.1: Zensical Architecture & Pipeline Hardening 📚

📝 Release Overview

This release finalizes the massive architectural shift for the Zenzic Documentation portal, completing the transition to our new Python-based static site generator (Zensical / MkDocs) and eradicating the final technical debt associated with the deprecated Node.js/Docusaurus stack.

In strict adherence to our Versioning Law, the documentation portal is now formally aligned and pinned to the v0.13.1 engine of Zenzic Core.

Architectural Changes & CI/CD

• Zensical Dual-Build Architecture: Consolidated the build pipeline to properly execute the ADR-020 Dual-Build strategy, generating output in the site/ and site/it/ directories using uv and zensical.
• Read The Docs Remediation: Exorcised the ghosts of npm and Node.js from the .readthedocs.yaml configuration. The RTD build environment is now strictly Python 3.12, utilizing uv for lightning-fast deterministic dependencies.
• Workflow Hardening: Fixed the release-docs.yml pipeline to correctly package and deploy the new site/ directory instead of the legacy build/ folder, unblocking Cloudflare Pages deployments.

Governance & Compliance

• Version Alignment: Bumped internal project references, pyproject.toml, and GitHub Actions to enforce the 0.13.1 Core standard and exact SHA pinning for Zenzic Actions (@37ffe97).
• DCO Enforcement: All commits retroactively signed and compliant with the Developer Certificate of Origin.

v0.11.0: Diátaxis Alignment for Monorepo & Routing Capabilities

Documentation Impact Analysis (D.I.A.)

This release synchronizes the documentation ecosystem with the v0.11.0 Core Engine updates, strictly adhering to the Diátaxis framework and the Bilingual Parity invariant (ADR-020).

Reference & Explanation Quadrants

• Configuration Reference: Updated excluded_dirs documentation to explicitly define the new .gitignore path-matching semantics (global basenames vs. repository-relative paths).
• Docusaurus Native Emulation: Documented Zenzic's new capability to statically resolve both URL-Based and File-Based Docusaurus links without Node.js execution.
• Known Limitations & Mitigations (Zero Hidden Debt): Added brutal transparency regarding Zenzic's physical boundaries. Documented the inability to dynamically evaluate Webpack @site aliases and sidebars.ts generated categories. Provided the official surgical .zenzic.toml mitigation strategy to silence Z101/Z104 on these specific paths without DQS penalties.

Ecosystem Governance

• The Golden Rule of Memory: The autonomous agent ledger (handoff_ledger.md) and .clinerules have been synchronized across the ecosystem, enforcing cross-repo memory consistency and the External Air-Gap Policy.

What's Changed

• chore(release): v0.11.0 by @PythonWoods-Dev in #90

Full Changelog: v0.10.4...v0.11.0

zenzic-doc 0.10.4 — Wordmark, blog post & security fixes

What's changed

Documentation

• New "Auditing the Auditors" case study blog post — covers the CI self-check incident and resolution
• New zenzic-doc SVG wordmark logo (light + dark) in official sky brand palette
• All badges centered with <p align="center"> in both README.md and README.it.md
• SSH commit signing setup instructions added to CONTRIBUTING.md

Security

• shell-quote CRITICAL (GHSA-w7jw-789q-3m8p) resolved via npm audit fix
• actions/checkout pinned to v6.0.3 SHA across all 9 workflows

CI

• Removed pull_request.paths filter from ci.yml — fail-closed: required checks now always created for every PR
• Added Z109 suppression for github.com/google/re2 transient connection errors in architecture.mdx (EN + IT)

Full changelog

https://github.com/PythonWoods/zenzic-doc/blob/main/CHANGELOG.md

v0.10.3: Z-Code Gallery Updates & Contributor Portal Hardening

This release updates the documentation portal to reflect the core linter enhancements of v0.10.3 and establishes new contributor guidelines aligned with enterprise standards.

📖 Documentation Impact Analysis (D.I.A.)

• Z-Code Gallery Routing: Updated the English and Italian reference documentation for Z102 (Anchor Missing), Z104 (File Not Found), and Z503 (Snippet Error) to document explicit anchors, footnote parsing, and custom YAML tag support.
• Diátaxis Compliance: Preserved the dry, lookup-only structure of finding-codes.mdx by routing detailed parser specs and examples exclusively to the tutorials gallery.

🛡️ Contribution Guidelines & Workflows

• Developer Portal Upgrade: Aligned the developer portal (pull-requests.mdx and index.mdx) and repository CONTRIBUTING.md / CONTRIBUTING.it.md guides to enforce the Issue-First Policy, mandatory GPG/SSH/S/MIME signatures, DCO sign-offs, and "No AI Slop" checks.
• Compliance Workflow: Integrated automated PR title linting and DCO validation into the repository's CI pipeline.

v0.10.1: Diátaxis Alignment & CI Naming Contract

What's New in v0.10.1

This release brings the official documentation perfectly in line with the Diátaxis framework boundaries and enforces the new organizational CI/CD naming standards.

Documentation & Diátaxis

• Reference Purity: Audited and purified the docs/reference/ quadrant. All philosophical explanations and step-by-step guides have been successfully migrated out of Reference files.
• Explanation Quadrant Alignment: Audited docs/explanation/ to ensure purely theoretical and architectural content without CLI execution steps.
• Tutorials & How-To: Audited the practical guides to remove deep theory and exhaustive tables, enforcing strict problem-oriented learning structures.

CI/CD & Governance

• Global CI Naming Contract: Aligned all GitHub Actions workflow files to the organizational naming standard (e.g., Zenzic Docs CI, Run Zenzic Quality Gate, Verify Badge Freshness).
• Gateway Contribution Policy: Removed duplicated workflow texts from CONTRIBUTING.md, transforming it into a strict pointer (Gateway) to the official developer documentation to prevent DRY violations.
• TOML Configuration Hardening: Restructured .zenzic.toml to enforce TOML parsing strictness, ensuring root keys (like strict and fail_under) are physically declared before any nested headers.

---

Full Changelog: v0.10.0...v0.10.1

v0.10.0 (Diamond)

Added

• Native CI Integration and Filtering Docs: Documented the new --ci shorthand and --format github-annotations in CLI Reference and CI/CD integration guides (EN + IT). Documented the --only flag for targeted rule filtering.
• Blog Post: Added new DevRel payload "Zenzic v0.10.0: Native GitHub Annotations and Progressive Adoption" demonstrating the killer features of v0.10.0.

Changed

• ADR-037 Install Guide Refinement: Removed the hardcoded version tag (@v0.10.0) from the Ephemeral GitHub execution instructions (uvx --from git+...) to decouple the command from temporal releases and point to the default branch.

v0.9.2 (Graphite)

v0.9.2 (Graphite)

This release delivers a complete structural overhaul of the documentation portal, strictly aligning it with the Diátaxis framework and standardizing the UI components.

Changed

• Architecture: Realigned all documentation into strict Diátaxis quadrants (Tutorials, How-To, Reference, Explanation).