Jeder Wert in einem inspect.software-Bericht — Komponenten, die zu Metriken zusammengefasst werden, Metriken, die zu Kategorien zusammengefasst werden, und der gesamte Gesundheitsindex — liegt auf einer standardisierten 1–100-Skala, höher ist besser. Damit diese Zahlen auf einen Blick lesbar sind, wird jeder Wert einer von sieben standardisierten Stufen zugeordnet, die einheitlich für Gesundheits-, Sicherheits- und Qualitätsmessungen verwendet werden. Jede Stufe trägt zudem eine kompakte Buchstabennote (C bis AAA) für Oberflächen, auf denen ein Wort keinen Platz findet.
Was jede Stufe bedeutet
| Stufe | Note | Bereich | Bedeutung |
|---|---|---|---|
| Außergewöhnlich | AAA | 93–100 | Die Spitzengruppe des Registers (≈ obere 5 %); erfüllt im Wesentlichen alle geprüften Kriterien |
| Exzellent | AA | 80–92 | Durchgehend stark; geringfügige Lücken |
| Gut | A | 65–79 | Gesund; Lücken sind begrenzt und beherrschbar |
| Mittel | BBB | 50–64 | Akzeptabel mit erheblichen Lücken; Überprüfung empfohlen |
| Schwach | BB | 35–49 | Wesentliche Schwächen in mehreren Bereichen |
| Gefährdet | B | 20–34 | Signifikante Schwächen; eine Übernahme verlangt Vorsicht |
| Kritisch | C | 1–19 | Schwerwiegende Probleme — z. B. aufgegeben, nur ein Maintainer, keine Hygiene |
Kalibriert auf das öffentliche Register
Die Stufenuntergrenzen des Gesamt-Gesundheitsindex sind keine willkürlichen runden Zahlen: Der Index ist auf die empirische Verteilung des öffentlichen Registers kalibriert (47.516 geprüfte Repositories zum Kalibrierungs-Snapshot), sodass jede Stufe angibt, wo ein Repository innerhalb des geprüften Open Source steht. Auf dem unkalibrierten gewichteten Mittel drängte sich die Hälfte des Registers in einem 20-Punkte-Abschnitt der Skala, und das oberste Dezil von Open Source lag in den hohen 70ern — Zahlen, die den Bereich 1–100 schlecht nutzten und jede Stufengrenze irreführend machten. Nach der Kalibrierung teilen die Stufen das Register in aussagekräftige, vergleichbar große Populationen, und Außergewöhnlich bedeutet, was Lesende darunter verstehen: ungefähr die oberen 5 % des geprüften Open Source.
Die Kalibrierungskurve ist eine feste Konstante der versionierten Methodik, kein live berechnetes Perzentil — die Bewertung eines Repositorys bewegt sich nur, wenn sich seine eigene Evidenz bewegt, nie weil andere Repositories geprüft wurden. Eine Rekalibrierung auf einen neueren Snapshot ist eine Versionserhöhung der Methodik wie jede andere, verzeichnet in jedem Bericht.
Bestimmte Negativbefund-Richtlinien begrenzen den Index unabhängig vom gewichteten Ergebnis: Eine ungeklärte Exposition gegenüber einer Hochrisikojurisdiktion hält den Index am oberen Ende von Gefährdet (34), und eine bestätigte schädliche Abhängigkeit oder ein erklärt aufgegebenes Projekt hält ihn innerhalb von Kritisch (19).
Wie Stufen zu lesen sind
- Stufen sind absichtlich grob. Der Unterschied zwischen 71 und 74 ist Rauschen; der Unterschied zwischen gut und gefährdet ist Information. Beschaffungs- und Prüfentscheidungen sollten sich an den Stufen und am Kategorienprofil orientieren, nicht an Einzelpunktdifferenzen. Die Vergleichsansicht ist genau darum herum gebaut: Sie weist die Spanne zwischen den angezeigten Einträgen in Indexpunkten aus, sodass ein Abstand von drei Punkten als solcher erkannt und beiseitegelegt werden kann.
- Stufen gelten auf jeder Ebene. Ein Repository kann insgesamt in der Stufe gut liegen, während eine Kategorie in kritisch liegt — die Stufen je Kategorie existieren genau dafür, dass Stärke in einem Bereich Risiko in einem anderen nicht stillschweigend verdecken kann. (Die Kalibrierung gilt für den Gesamtindex; Kategorie- und Metrikwerte werden direkt denselben Schwellwerten zugeordnet.)
- Schwellwerte sind versioniert. Stufengrenzen sind Teil der Methodik und ändern sich nur mit einer Versionserhöhung, die in jedem Bericht verzeichnet ist — siehe Methodikversionen.
Zertifizierungsstufen
Die drei Stufen oberhalb von Mittel tragen die Zertifizierungsstufen des Registers: Certified (Gut, Note A), Certified with Excellence (Exzellent, Note AA) und Certified AAA (Außergewöhnlich). Eine Zertifizierungsstufe ist die Bewertungsstufe, die die veröffentlichte Evidenz stützt, ausgedrückt als Zertifizierungszeichen — siehe wie Stufen erworben werden und sich ändern sowie Zertifizierung & Preise für den kostenpflichtigen Weg auf Anfrage.
Wo die Stufen erscheinen
Die Stufen steuern die Farbcodierung im gesamten Register: Katalogkarten, die Berichtsanzeige, Kategorieköpfe, einzelne Metrikkarten und das GitHub-Badge. Ein Repository ohne abgeschlossene Prüfung zeigt einen neutralen Zustand ausstehend statt einer Stufe.
Verwandt: der Gesundheitsindex erklärt, wie die zugrunde liegenden 1–100-Werte berechnet werden; Signale, keine Garantien erklärt, was sie beanspruchen und was nicht.