Methodik von Qualitätsnote & Ranking

Stufen

• SQualität

  ≥ 85

  S braucht zusätzlich Sicherheitsnote A.

• AQualität

  ≥ 70

• BQualität

  ≥ 55

• CQualität

  < 55

Bestandteile und Gewichtung

Jeder Bestandteil wird von 0 bis 100 bewertet; die Qualitätspunkte sind die gewichtete Summe. Sie werden täglich und nach jeder neuen Version neu berechnet.

• Sicherheit35%

  Die Punkte der Sicherheitsnote (siehe Sicherheits-Methodik).

• Pflege20%

  Wie aktuell die letzte Version ist und – falls bekannt – wann zuletzt ins Upstream-Repository gepusht wurde (60/40).

  ≤ 30 T.: 100 · ≤ 90 T.: 80 · ≤ 180 T.: 60 · ≤ 365 T.: 40 · > 365 T.: 15

• Dokumentation20%

  Eine README mit Substanz, Beispiele oder Code-Blöcke, eine klare Beschreibung und die optionalen Felder „Wann nutzen / wann nicht“.

  README ≥ 300 Zeichen 30 · Beispiele 25 · Beschreibung ≥ 50 Zeichen 15 · Wann nutzen 20 · Wann nicht 10

• Nutzung15%

  Installationen (eindeutige Clients pro Tag, letzte 30 Tage) und aktive Installationen (die meisten eindeutigen Clients, die an einem Tag installiert, aktualisiert oder geprüft haben), jeweils logarithmisch: 10 → 25, 100 → 50, 1.000 → 75, 10.000 → 100.

• Bewertungen10%

  Ein bayesscher Mittelwert der Sterne, damit eine einzelne 5-Sterne-Bewertung nicht viele gute überholt.

  Vorannahme: 5 virtuelle Bewertungen mit 3.5 Sternen; ohne Bewertungen = neutral.

Keine aufgeblähten Zahlen

• Bots und Crawler werden gar nicht erfasst (Prüfung des User-Agents).
• Installationen aus CI (CI, GITHUB_ACTIONS, GITLAB_CI, BUILDKITE … gesetzt) werden getrennt gespeichert und nie in Ranglisten, Noten oder öffentlichen Zahlen gezählt.
• Installationen zählen eindeutige Clients pro Tag: Dieselbe Maschine, die 1.000-mal am Tag installiert, zählt einmal.
• Besuche der Autoren auf ihrer eigenen Paketseite zählen nicht als Aufrufe.
• Clients werden mit einem täglich gesalzenen Hash unterschieden; es wird keine IP-Adresse gespeichert. Details: Analytics & Datenschutz.

Ranglisten und Sortierung

Top-Listen, Trends und die Sortierung „Qualität“ nutzen dieselben gefilterten Zahlen. Trends vergleicht Installationen im gewählten Zeitraum; die Qualitäts-Sortierung nutzt die Qualitätspunkte, die Noten-Sortierung die Sicherheitsnote.

Quelle der Regeln: packages/db/src/quality.ts