From 453b02ce959ec6be84ae3efbdce071f368b69239 Mon Sep 17 00:00:00 2001 From: PythonWoods Date: Thu, 2 Apr 2026 19:35:59 +0200 Subject: [PATCH 1/5] fix(docs): sync topbar and bumpversion with v0.5.0a1 --- mkdocs.yml | 2 +- pyproject.toml | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/mkdocs.yml b/mkdocs.yml index f6f4f1b..45c6e70 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -142,7 +142,7 @@ extra_css: extra: build_date: !ENV [BUILD_DATE, "dev"] generator: false - version: "0.4.0rc5" + version: "0.5.0a1" social: - icon: fontawesome/brands/github link: https://github.com/PythonWoods/zenzic diff --git a/pyproject.toml b/pyproject.toml index 4377bae..82c7b24 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -167,7 +167,7 @@ exclude_lines = [ # ─── Version bumping ─────────────────────────────────────────────────────────── [tool.bumpversion] -current_version = "0.4.0rc4" +current_version = "0.5.0a1" commit = true tag = true tag_name = "v{new_version}" From 1fb29fec919498dc80306aa8516311ebb55d989e Mon Sep 17 00:00:00 2001 From: PythonWoods Date: Thu, 2 Apr 2026 19:40:30 +0200 Subject: [PATCH 2/5] fix(docs): derive topbar version from tag or pyproject --- .github/workflows/deploy-docs.yml | 9 +++++++++ mkdocs.yml | 2 +- 2 files changed, 10 insertions(+), 1 deletion(-) diff --git a/.github/workflows/deploy-docs.yml b/.github/workflows/deploy-docs.yml index 9175d62..3049fa4 100644 --- a/.github/workflows/deploy-docs.yml +++ b/.github/workflows/deploy-docs.yml @@ -77,6 +77,15 @@ jobs: cd docs/assets/brand zip -r ../brand-kit.zip . + - name: Set docs version for topbar + run: | + if [[ "${GITHUB_REF}" == refs/tags/v* ]]; then + echo "DOCS_VERSION=${GITHUB_REF_NAME}" >> "$GITHUB_ENV" + else + VERSION=$(python3 -c "import tomllib; print('v' + tomllib.load(open('pyproject.toml','rb'))['project']['version'])") + echo "DOCS_VERSION=${VERSION}" >> "$GITHUB_ENV" + fi + - name: Build Documentation run: uv run mkdocs build --strict diff --git a/mkdocs.yml b/mkdocs.yml index 45c6e70..c0faf92 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -142,7 +142,7 @@ extra_css: extra: build_date: !ENV [BUILD_DATE, "dev"] generator: false - version: "0.5.0a1" + version: !ENV [DOCS_VERSION, "dev"] social: - icon: fontawesome/brands/github link: https://github.com/PythonWoods/zenzic From ea9ac45de0a8a85a4f4996816b32018cb0db042d Mon Sep 17 00:00:00 2001 From: PythonWoods Date: Thu, 2 Apr 2026 19:42:40 +0200 Subject: [PATCH 3/5] ci(docs): deploy Cloudflare production docs from main only --- .github/workflows/deploy-docs.yml | 18 +++++------------- 1 file changed, 5 insertions(+), 13 deletions(-) diff --git a/.github/workflows/deploy-docs.yml b/.github/workflows/deploy-docs.yml index 3049fa4..df770af 100644 --- a/.github/workflows/deploy-docs.yml +++ b/.github/workflows/deploy-docs.yml @@ -7,7 +7,6 @@ on: push: branches: - main - - 'release/**' paths: - 'docs/**' - 'mkdocs.yml' @@ -16,9 +15,6 @@ on: - 'SECURITY.md' - 'noxfile.py' - '.github/workflows/deploy-docs.yml' - # Trigger on tags regardless of paths changed - tags: - - 'v*' pull_request: branches: - main @@ -79,24 +75,20 @@ jobs: - name: Set docs version for topbar run: | - if [[ "${GITHUB_REF}" == refs/tags/v* ]]; then - echo "DOCS_VERSION=${GITHUB_REF_NAME}" >> "$GITHUB_ENV" - else - VERSION=$(python3 -c "import tomllib; print('v' + tomllib.load(open('pyproject.toml','rb'))['project']['version'])") - echo "DOCS_VERSION=${VERSION}" >> "$GITHUB_ENV" - fi + VERSION=$(python3 -c "import tomllib; print('v' + tomllib.load(open('pyproject.toml','rb'))['project']['version'])") + echo "DOCS_VERSION=${VERSION}" >> "$GITHUB_ENV" - name: Build Documentation run: uv run mkdocs build --strict - name: Deploy to Cloudflare Pages - # Allow deploy on push to main, workflow_dispatch, or version tags + # Production docs deploy only from main (or manual dispatch on main) if: | (github.event_name == 'push' || github.event_name == 'workflow_dispatch') && - (github.ref == 'refs/heads/main' || startsWith(github.ref, 'refs/tags/v')) + github.ref == 'refs/heads/main' uses: cloudflare/wrangler-action@v3 with: apiToken: ${{ secrets.CLOUDFLARE_API_TOKEN }} accountId: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }} - # Use 'main' as the production branch for Cloudflare regardless of tag name + # Deploy production docs from the merged main branch only. command: pages deploy site --project-name=zenzic --branch=main --commit-dirty=true From b4a002fddcfec77730f96586936cba5f22eccd9e Mon Sep 17 00:00:00 2001 From: PythonWoods Date: Thu, 2 Apr 2026 19:51:01 +0200 Subject: [PATCH 4/5] docs(legal): clarify project ownership and third-party tool attribution --- NOTICE | 5 +++++ README.it.md | 3 +++ README.md | 3 +++ docs/about/index.md | 3 +++ docs/it/about/index.md | 3 +++ 5 files changed, 17 insertions(+) diff --git a/NOTICE b/NOTICE index 753bf3d..1564092 100644 --- a/NOTICE +++ b/NOTICE @@ -4,6 +4,11 @@ Copyright 2026 PythonWoods This product includes software developed by the PythonWoods contributors. +Project attribution: + +- Zenzic is a PythonWoods project. +- Zensical, MkDocs, and other referenced ecosystem tools are third-party projects. + ================================================================================ ## Runtime Dependencies diff --git a/README.it.md b/README.it.md index 15effd1..09cec42 100644 --- a/README.it.md +++ b/README.it.md @@ -40,6 +40,9 @@ Zenzic è **agnostico** — funziona con qualsiasi sistema di documentazione bas sono un errore bloccante, e se dichiari `engine = "zensical"` devi avere `zensical.toml` — nessun fallback, nessuna supposizione. +Attribuzione del progetto: Zenzic è un progetto PythonWoods. Zensical, MkDocs e +gli altri strumenti citati sono progetti di terze parti. + --- ## v0.5.0a1 — La Sentinella diff --git a/README.md b/README.md index 2a72594..051305f 100644 --- a/README.md +++ b/README.md @@ -40,6 +40,9 @@ or a bare folder of `.md` files) without installing any build framework. And it absolute links are a hard error, and if you declare `engine = "zensical"` you must have `zensical.toml` — no fallback, no guessing. +Project attribution: Zenzic is a PythonWoods project. Zensical, MkDocs, and other +referenced ecosystem tools are third-party projects. + --- ## v0.5.0a1 Highlights — The Sentinel diff --git a/docs/about/index.md b/docs/about/index.md index 87cf834..0212de7 100644 --- a/docs/about/index.md +++ b/docs/about/index.md @@ -11,6 +11,9 @@ Zenzic is an engineering-grade documentation linter and quality gate for any Mar Built by [PythonWoods](https://github.com/PythonWoods), it is designed to run in CI/CD pipelines and catch documentation issues before they reach users. +Attribution: Zenzic is a PythonWoods project. Zensical, MkDocs, and other +ecosystem tools referenced in this documentation are third-party projects. + ---
diff --git a/docs/it/about/index.md b/docs/it/about/index.md index d1ccb50..30f5ef3 100644 --- a/docs/it/about/index.md +++ b/docs/it/about/index.md @@ -11,6 +11,9 @@ Zenzic è un linter di documentazione di livello ingegneristico e un quality gat Sviluppato da [PythonWoods](https://github.com/PythonWoods), è progettato per essere eseguito nelle pipeline CI/CD e rilevare i problemi nella documentazione prima che raggiungano gli utenti. +Attribuzione: Zenzic è un progetto PythonWoods. Zensical, MkDocs e gli altri +strumenti dell'ecosistema citati in questa documentazione sono progetti di terze parti. + ---
From 0b97410a94273ef3a2d238ac92bac7b2dc407565 Mon Sep 17 00:00:00 2001 From: PythonWoods Date: Thu, 2 Apr 2026 20:01:48 +0200 Subject: [PATCH 5/5] docs(readme): declare Zensical compatibility baseline v0.0.31+ --- README.it.md | 2 ++ README.md | 2 ++ 2 files changed, 4 insertions(+) diff --git a/README.it.md b/README.it.md index 09cec42..080deb4 100644 --- a/README.it.md +++ b/README.it.md @@ -40,6 +40,8 @@ Zenzic è **agnostico** — funziona con qualsiasi sistema di documentazione bas sono un errore bloccante, e se dichiari `engine = "zensical"` devi avere `zensical.toml` — nessun fallback, nessuna supposizione. +Baseline di compatibilità attuale con Zensical: **v0.0.31+**. + Attribuzione del progetto: Zenzic è un progetto PythonWoods. Zensical, MkDocs e gli altri strumenti citati sono progetti di terze parti. diff --git a/README.md b/README.md index 051305f..a4eb7b9 100644 --- a/README.md +++ b/README.md @@ -40,6 +40,8 @@ or a bare folder of `.md` files) without installing any build framework. And it absolute links are a hard error, and if you declare `engine = "zensical"` you must have `zensical.toml` — no fallback, no guessing. +Current Zensical compatibility baseline: **v0.0.31+**. + Project attribution: Zenzic is a PythonWoods project. Zensical, MkDocs, and other referenced ecosystem tools are third-party projects.