Skip to content

chore(docs): drop the mkdocs site configuration - #27

Merged
kieronlanning merged 1 commit into
mainfrom
chore/drop-mkdocs-site-config
Nov 16, 2026
Merged

kieronlanning merged 1 commit into
mainfrom
chore/drop-mkdocs-site-config

Conversation

@kieronlanning

Copy link
Copy Markdown
Contributor

purview.dev aggregates this repository's Markdown directly: the catalogue record in
.config/purview-docs.yml (docs.path, docs.rootPage, docs.exclude) decides what is
published, and the portal never reads mkdocs.yml. While the file exists the portal's docs sync
prints an advisory for this repository on every run (mkdocs.yml is a repository site configuration and the portal ignores it).

Removing it is a docs-only change: nothing publishes differently and no version bump is needed.

docs/wiki/index.md is deliberately kept: with Home.md in docs.exclude it is the landing page purview.dev publishes at /docs/containers/.

See skills/purview-site-docs / skills/docs-aggregation-rules in purview-dev/purview-dev —
a repository that still ships a site configuration is a deviation the portal ignores.

File Action
mkdocs.yml deleted

purview.dev aggregates this repository's Markdown directly: the catalogue
record in .config/purview-docs.yml decides what is published and the portal
never reads mkdocs.yml, so the file is dead weight here. Removing it stops
the portal's sync printing its legacy site-configuration advisory.

docs/wiki/index.md stays: with Home.md excluded it is the landing page
purview.dev publishes at /docs/containers/.
@kieronlanning
kieronlanning enabled auto-merge (squash) November 16, 2026 12:02
@kieronlanning
kieronlanning merged commit 9e4f7d7 into main Nov 16, 2026
2 of 3 checks passed
@kieronlanning
kieronlanning deleted the chore/drop-mkdocs-site-config branch November 16, 2026 12:05
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant