Changelog & versioning¶

Wiki-Wooosh follows Semantic Versioning and the Keep a Changelog format.

Versioning scheme

MAJOR.MINOR.PATCH

MAJOR — breaking IA changes (section restructure, template contract change).
MINOR — new sections, new source adapters, new pipelines (backwards-compatible).
PATCH — content fixes, small tweaks, dependency bumps.

Current version: v0.3.0

How versions are cut¶

Land changes via PR (all checks green).
Bump the version in docs-site/mkdocs.yml (extra.version) and add a section here.
Tag the commit docs-vX.Y.Z.
For multi-version docs at scale, publish with mike:
```
uv run mike deploy --update-aliases 0.3 latest
uv run mike set-default latest
```
The theme's version selector then lets readers switch between published versions.

Setup section: prerequisites, full importable n8n workflow (annotated node-by-node), Azure Pipelines (with inline comments), and an end-to-end sequence walkthrough.
quality-security.yml pipeline: dependency check (pip-audit, trivy fs), code quality (ruff, yamllint, markdownlint), and security (gitleaks, bandit, trivy config).
Changelog & versioning page (this page).
Persistent Cloudflare tunnel (systemd) on runbook.cloudysnake.com.

Renamed the site to Wiki-Wooosh.
Reworked all landing pages to use native Material grid cards (fixed broken custom-HTML cards / empty boxes).
Migrated the executive brief into the site as the Proposal section.

MkDocs Material site with sections: Home, Onboarding, Infra, Runbooks, Cheatsheets, Tools & Processes, FAQ.
New source adapters in the reference implementation: SharePoint (docs/Excel/legacy, full create/update/delete), Power BI + ServiceNow reports, Teams/Outlook comms.
Confidential → link-only handling; deletes → tombstones; legacy → short summary.

Lean architecture: existing Azure DevOps + n8n + Azure OpenAI; ~$30–50/mo, no new infra.

Wiki content scaffold, page templates, front-matter contract, CI validators.
Reference implementation: normalized-event bus, pluggable LLM adapter, router → drafter → PR builder, RAG chunker.
Ansible-aware Azure Repos adapter; doc-drift report; end-to-end demo.