For AI agents: the complete documentation index is available at https://mfdoctor.kevinbeier.com/de/llms.txt, the full documentation bundle is available at https://mfdoctor.kevinbeier.com/de/llms-full.txt, and this page is available as Markdown at https://mfdoctor.kevinbeier.com/de/docs-lifecycle.md.

Dies ist die deutsche MFDoctor-Dokumentation. Technische Bezeichner, CLI-Flags, Regel-IDs und Codebeispiele bleiben unverändert, damit die Inhalte zwischen den Sprachen vollständig kompatibel bleiben. Verwenden Sie den Sprachumschalter für die kanonische englische Fassung.

Lebenszyklus der Dokumentation

MFDoctor keeps one canonical documentation surface: the English content at mfdoctor.kevinbeier.com. Release metadata, localization, and API references are backed by maintained inputs before they become navigation surfaces.

Release-basierter Versionshinweis

The header version link is generated from the repository root package.json. It displays the current package version and points to the exact matching GitHub release tag. The same version is published at the @tonoizer/mfdoctor npm package.

The release workflow owns the invariant:

  1. the Changesets release PR updates package.json;
  2. the merged version is published to npm;
  3. the matching GitHub release tag is created;
  4. the docs deployment exposes that version link.

The docs build rejects a missing or non-semver package version rather than rendering a guessed label.

Sprachrichtlinie

English is the canonical language and @tonoizer is the maintainer for its technical accuracy. German is published alongside English and is maintained by @tonoizer under the same release gate. The language selector is enabled only when every canonical page has a matching German route.

Each published translation must have:

  • a named owner and a release review;
  • parity with the canonical page set, including CLI flags, schemas, and rule links;
  • canonical and alternate links that resolve in the production build;
  • a documented policy for keeping release-specific examples current.

Technical identifiers, CLI flags, rule IDs, schemas, links, and code examples remain contract-identical across languages. German UI labels and explanatory copy are reviewed with the release; the parity check prevents a German route from silently disappearing when an English page is added.

Richtlinie für die API-Referenz

The public API surface is generated from package.json#exports and checked in the docs build. It lists every runtime and JSON Schema entry point without inventing a hand-maintained symbol catalog. A detailed symbol-level reference can be added later only when it is generated from published declarations and contract-tested against those exports; an empty API tab is not an acceptable placeholder.

Zuständigkeiten und Aktualisierungsregeln

SurfaceOwnerUpdate triggerRequired proof
Canonical English guides and rules@tonoizerFeature, rule, or release behavior changesDocs build and link checks
Release indicatorRelease workflow + @tonoizerPackage version or GitHub release changesPackage semver and exact release tag link
German translation@tonoizerCanonical page changesContent parity and production link checks
API surface catalogPackage export mapPublic entry-point changesGenerated-doc drift check