Engineering-Qualität misst, ob grundlegende Engineering- und Dokumentationspraktiken vorhanden sind: Continuous Integration, automatisierte Tests, Lint- und Formatdisziplin sowie Dokumentation, aus der ein Neuling tatsächlich lernen kann. Es sind die Praktiken, die Änderungen sicher machen — für menschliche Beitragende und zunehmend für KI-Coding-Agenten.
Die Kategorie trägt 20% des gesamten Gesundheitsindex.
Metriken in dieser Kategorie
| Metrik | Gewicht in der Kategorie | Gewicht im Gesamtindex |
|---|---|---|
| Engineering-Praktiken | 60% | 12% |
| Dokumentation | 40% | 8% |
Engineering-Praktiken ist eine gewichtete Checkliste von Hygienebelegen: CI-Workflows, eine Testsuite, Linter-Konfiguration, Pre-commit-Hooks und eine .editorconfig. Dokumentation misst, ob das Projekt sich selbst erklärt: README, ein Dokumentationsverzeichnis oder eine Dokumentationsseite, Repository-Beschreibung, Topics und Wiki.
Was diese Kategorie bewusst misst
Die Signale sind vorhandenseinsbasiert: Sie bestätigen, dass die Infrastruktur existiert, nicht, wie gut sie ist. Diese Zurückhaltung ist beabsichtigt — Test-*Qualität* oder Dokumentations-*Prosa* von außen zu benoten wäre Rätselraten im Gewand einer Messung. Vorhandenseinssignale sind günstig zu verifizieren, schwer zu bestreiten und trennen disziplinierte Projekte bereits bemerkenswert gut von undisziplinierten. Tiefere Signale (Coverage, CI-Erfolgsraten) stehen auf der Methodik-Roadmap und kommen mit einer Versionserhöhung.
Den Kategoriewert lesen
- Ein niedriger Wert lügt hier selten: Fehlende CI und fehlende Tests sind sichtbare Fakten, keine Ermessensentscheidungen.
- Ein hoher Wert bedeutet, dass das Gerüst der Qualität vorhanden ist. Er zertifiziert nicht, dass der Code darin gut ist — siehe Signale, keine Garantien.
- Dokumentation wiegt 40%: Ein gut getestetes Projekt, das Neulingen nichts erklärt, ist messbar schwerer zu übernehmen, und die Kategorie bildet das ab.
Engineering-Qualität verbessern
- CI hinzufügen, die die Testsuite bei jedem Push und Pull Request ausführt — die zwei schwersten Komponenten der Engineering-Praktiken.
- Linter- und Formatter-Konfiguration einchecken; für die volle Punktzahl Pre-commit-Hooks und eine
.editorconfigergänzen. - Ein echtes README, ein
docs/-Verzeichnis oder eine Dokumentationsseite, eine Repository-Beschreibung und Topics pflegen — jedes davon ist eine einzeln gewichtete Komponente der Dokumentation.
Verwandt: KI-Bereitschaft · der Gesundheitsindex