From 2085dccf76710282023e9e9bec6e43f95b4d1086 Mon Sep 17 00:00:00 2001 From: Kieron Lanning Date: Sat, 7 Nov 2026 09:40:13 +0000 Subject: [PATCH] docs: state the site-configuration deviation instead of claiming it is gone build-sdk and the portal still carry a site file beside their documentation. The rule says the wiki is plain Markdown and the portal reads that, so the pages now name the deviation rather than asserting every repository has dropped it. --- docs/wiki/foundations/Documentation-Convention.md | 4 +++- docs/wiki/governance/Cross-Repository-Harvest.md | 8 ++++---- 2 files changed, 7 insertions(+), 5 deletions(-) diff --git a/docs/wiki/foundations/Documentation-Convention.md b/docs/wiki/foundations/Documentation-Convention.md index 11d952f..8ffd9ad 100644 --- a/docs/wiki/foundations/Documentation-Convention.md +++ b/docs/wiki/foundations/Documentation-Convention.md @@ -28,7 +28,9 @@ folder this playbook publishes from. Of the seventeen public repositories in the use `docs/wiki`; `architests`, `value-objects` and `purview-dev.github.io` publish from `docs`, and `pm-skills` publishes no documentation folder at all, documenting itself through its skills. What the rule requires is the part those repositories share: the documentation lives with the code it describes, -as Markdown, with its navigation in the folder beside it. The folder name is the only part that varies. +as Markdown, with its navigation in the folder beside it. The folder name is the part that varies. Some +repositories still carry a site configuration file from before the portal read Markdown directly; it is +harmless, the portal ignores it, and this playbook does not ship one. [Cross-Repository Harvest](../governance/Cross-Repository-Harvest.md) records the deviations by name. ## Why diff --git a/docs/wiki/governance/Cross-Repository-Harvest.md b/docs/wiki/governance/Cross-Repository-Harvest.md index 99a6895..67b7c77 100644 --- a/docs/wiki/governance/Cross-Repository-Harvest.md +++ b/docs/wiki/governance/Cross-Repository-Harvest.md @@ -76,10 +76,10 @@ publish from `docs`, and `pm-skills` publishes no documentation folder at all, d through its eighteen skills. That is not seventeen repositories getting a rule wrong; it is one repository's shape written down as if -it were universal. What the rule actually requires is that the documentation lives with the code — the -folder name is the part that varies, and nothing else does, because no repository carries a site -configuration any more (`astroc4` publishes `docs/wiki` and nothing beside it). The convention page now -says so, and names each deviation rather than pretending the rule was followed. +it were universal. What the rule actually requires is that the documentation lives with the code, as +Markdown the portal can read: the folder name is the part that varies, and `astroc4` publishes +`docs/wiki` with no site configuration beside it, which is the shape the rule now states. The convention +page now says so, and names each deviation rather than pretending the rule was followed. ## How it is enforced