Skip to content

History / Coding Standards

Revisions

  • Add the one-implementation-per-security-primitive family [#1048] Section 1 listed every architecture rule family a change is held to except this one, while two conformance rules already enforced it. A contributor met the family as a red build with no page explaining why the rule exists or how far it reaches, which is the drift the single-home doctrine exists to stop. The entry names both fitness functions, does not restate their mechanics, and states the limit both share: they are source scans, so a second construction inside an already-declared file and a path that reaches the same decision without naming the library type are outside them, and the review gate owns those. Written from the rules on main rather than from the issue's sketch, which named the OpenID rule under a working title it did not ship under.

    @iderex iderex committed Aug 12, 2026
  • Replace the typographic dashes on every page 612 dashes across 22 of the 30 pages. No page ends a line with a space afterwards, and 566 dashes that would have started a Markdown list are escaped so the list does not appear. A wiki has no pull request and no gate, so the counts before and after are the evidence: the run is recorded in iderex/operations#861. Part of the fleet-wide pass in iderex/operations#860. Signed-off-by: Nils Lehnen <30603423+iderex@users.noreply.github.com>

    @iderex iderex committed Aug 9, 2026
  • Stop citing the de-published docs/ARCHITECTURE.md [#987] #987 un-tracked docs/ARCHITECTURE.md so it lives only in the local docs/ area. Two wiki citations of that path survived and became dead public links, which is what Wiki Lint has been failing on since the #996 merge. The Architecture page no longer presents itself as a distillation of an in-repo source that readers cannot open: it is the single home for the architecture, with the code and its conformance tests still winning any disagreement. The migration issue references it carried are kept, now as working links rather than plain text. Coding-Standards named CLAUDE.md and docs/ARCHITECTURE.md alongside CONTRIBUTING.md as the files that point here; neither is public, so the sentence described the repository to readers who cannot verify it. It now names only CONTRIBUTING.md. Verified with the real gate against a tracked-only tree built from origin/main (git archive), because the un-tracked file is still present on a working checkout and makes a local run report clean either way: the unmodified wiki reproduces both findings and exit 1, this state reports clean and exit 0. Signed-off-by: iderex <30603423+iderex@users.noreply.github.com>

    @iderex iderex committed Jul 25, 2026
  • Consolidate the wiki: canonical Coding Standards, merged Architecture, split Provider Setup Restructure the wiki into one coherent, audience-grouped set with a single home for each fact. - New Coding-Standards page: the one canonical statement of the architecture, comment/documentation (#864), and object-oriented rules; the repo's CLAUDE.md and CONTRIBUTING.md now point here instead of restating them. - Merged the two stale, mutually-overlapping Architecture pages into one, re-based on the current module-DAG reality (the old pages claimed the module split was "not pursued" and that no IPluginServiceRegistrator existed — both were wrong and contradicted docs/ARCHITECTURE.md). Cites modules and types, never file:line, so it cannot drift on a move again. - Split Provider-Setup (1172 lines, ~73% not provider-specific) into Provider Setup (recipes) + a new Hardening & Options Reference; folded the security- control narrative into the Security Model. Every moved section left a pointer. - Merged Release-Policy + Release-QA-Checklist into Releasing (renamed the per-release ladder to "release promotion ladder" to end the Beta-rung name collision); merged OpenSSF-Best-Practices + Maturity-Map into Security & Maturity Self-Assessment. Old slugs kept as redirect stubs. - Rebuilt the sidebar into four audience groups (Getting started / How it works / Security / Standards & process). Fixed the broken anchors, corrected the beta publish-trigger to the daily scheduler (it is not "every merge"), de-referenced the design records to module/type names, and trimmed Home's README duplication.

    @iderex iderex committed Jul 20, 2026