Skip to content

feat: replace prescribed versions with the registry rule and drop the site - #13

Merged
kieronlanning merged 1 commit into
mainfrom
feat/version-rule-and-plain-markdown
Nov 7, 2026
Merged

kieronlanning merged 1 commit into
mainfrom
feat/version-rule-and-plain-markdown

Conversation

@kieronlanning

Copy link
Copy Markdown
Contributor

Summary

Brings the playbook up to date with the organisation as it is today, and fixes two things the pages got wrong.

The organisation snapshot is current again

  • astroc4 was missing entirely, and six repositories had moved since the last harvest.
  • Regenerated from gh; just org-inventory reports no drift (17 public repositories).
  • The catalogue claim is corrected: 17 project files, one archived; openapi-xmlcomments now has an entry, and the one repository without an entry is the catalogue itself.

Versions are a rule, not a ledger

  • New page foundations/Dependency-Versions.md, stated as principle 11: an application takes the latest version its runtime supports; a published component declares the lowest version that compiles and passes, per target framework.
  • Current releases are shown as registry badges, so a page cannot go stale within a release.
  • Getting-Started and templates/ keep the shape (one property per family) and drop the version list.

The documentation site is gone

  • mkdocs.yml, templates/mkdocs.yml and docs/wiki/index.md are deleted, and every reference is removed: the wiki is plain Markdown, _Sidebar.md is the navigation, and the portal publishes the folder from its catalogue entry. The false techdocs-core requirement is replaced with how the portal actually publishes.

New skill: purview-component-compatibility

The golden rule, the Purview component hierarchy read from the registry, and scripts/dependencies.mjs (zero dependency) which prints each dependency group and its minimums per target framework.

Verification

  • dotnet build: 0 warnings, 0 errors
  • dotnet test: 91 total, 86 passed, 0 failed, 5 pre-existing skips
  • just lint-check: clean
  • node scripts/dependencies.mjs: exercised against five live packages, including the net10.0-windows group
  • The skill conformance suite was proved to cover the new skill by breaking its frontmatter name on purpose and watching the test fail

… site

Record astroc4 and refresh every moved repository in the organisation snapshot, and correct the claim that the portal reads a project's site configuration.

State the version rule the playbook was missing: an application takes the latest version its runtime supports, a published component declares the lowest version that compiles and passes per target framework, and a page shows a registry badge rather than a number that is wrong within a release.

Add the purview-component-compatibility skill: the golden rule, the Purview component hierarchy as read from the registry, and a zero-dependency script that prints each dependency group so a floor is read rather than remembered.

Remove the documentation site entirely. The wiki is plain Markdown, the portal publishes it from the catalogue entry, and no repository carries a site configuration: the configuration file, its template and the wiki index page are deleted.

Bump TUnit, the telemetry generator and the pipeline tool to their current releases so the repository still demonstrates what it documents.
@kieronlanning
kieronlanning merged commit 93f0dea into main Nov 7, 2026
1 check passed
@kieronlanning
kieronlanning deleted the feat/version-rule-and-plain-markdown branch November 7, 2026 09:39
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