docs: sync docs-versioning policy and clarify compatibility baseline#25
Merged
PythonWoods-Dev merged 5 commits intomainfrom Apr 2, 2026
Merged
docs: sync docs-versioning policy and clarify compatibility baseline#25PythonWoods-Dev merged 5 commits intomainfrom
PythonWoods-Dev merged 5 commits intomainfrom
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Description:
This PR finalizes documentation consistency after v0.5.0a1 release.
What’s included:
Docs topbar version anti-drift:
mkdocs.yml now reads version from DOCS_VERSION env (fallback dev).
deploy-docs.yml sets DOCS_VERSION from pyproject.toml.
Production Cloudflare deploy is now restricted to main only, preventing docs from getting ahead of merged code/release state.
Ownership/attribution clarity:
Added explicit attribution that Zenzic is a PythonWoods project.
Clarified that Zensical, MkDocs, and other ecosystem tools are third-party projects.
Applied in NOTICE, README (EN/IT), and About pages (EN/IT).
Compatibility wording:
Declared explicit baseline as Zensical v0.0.31+ in README (EN/IT).
Why v0.0.31+:
It reflects the minimum supported baseline rather than a single pinned patch.
It matches migration/config docs already referencing Zensical v0.0.31+.
It avoids unnecessary documentation churn for compatible patch/minor updates.
Validation:
markdownlint passed for updated README files.
workflow YAML checks passed.
mkdocs build --strict passed.
pre-commit hooks passed during commits.