Кожне значення у звіті inspect.software — компоненти, згорнуті в метрики, метрики, згорнуті в категорії, та загальний індекс здоров'я — живе на одній стандартизованій шкалі 1–100, де більше — краще. Щоб ці числа читалися з одного погляду, кожне значення відповідає одному з семи стандартизованих діапазонів, які послідовно застосовуються до вимірювань здоров'я, безпеки та якості. Кожен діапазон також має компактну літерну оцінку (від C до AAA) для місць, де слово не вміщується.
Що означає кожен діапазон
| Діапазон | Оцінка | Межі | Значення |
|---|---|---|---|
| Винятковий | AAA | 93–100 | Найвищий рівень реєстру (≈ топ-5%); відповідає практично всім перевіреним критеріям |
| Відмінний | AA | 80–92 | Сильний за всіма напрямами; незначні прогалини |
| Добрий | A | 65–79 | Здоровий; прогалини обмежені й керовані |
| Помірний | BBB | 50–64 | Прийнятний, але з помітними прогалинами; рекомендовано перегляд |
| Слабкий | BB | 35–49 | Істотні слабкості в кількох сферах |
| У зоні ризику | B | 20–34 | Суттєві слабкості; впровадження потребує обережності |
| Критичний | C | 1–19 | Серйозні проблеми — наприклад, покинутий проєкт, єдиний мейнтейнер, відсутність гігієни |
Відкалібровано за публічним реєстром
Нижні межі діапазонів для загального індексу здоров'я — не довільні круглі числа: індекс відкалібровано за емпіричним розподілом публічного реєстру (47 516 проінспектованих репозиторіїв на момент калібрувального зрізу), тож кожен діапазон каже, де репозиторій стоїть серед інспектованого відкритого коду. На невідкаліброваному зваженому середньому половина реєстру тіснилася на відрізку шкали у 20 балів, а верхній дециль відкритого коду сидів у високих 70-х — ці числа погано використовували діапазон 1–100 і робили кожну межу діапазону оманливою. Після калібрування діапазони ділять реєстр на змістовні, порівнянні за розміром популяції, і Винятковий означає саме те, що читач і припускає: приблизно топ-5% інспектованого відкритого коду.
Калібрувальна крива — фіксована константа версіонованої методології, а не живий перцентиль: оцінка репозиторію рухається лише тоді, коли рухаються його власні свідчення, і ніколи — через те, що було проінспектовано інші репозиторії. Перекалібрування за новішим зрізом — це таке саме підвищення версії методології, як і будь-яке інше, зафіксоване в кожному звіті.
Окремі політики тривожних сигналів обмежують індекс незалежно від зваженого результату: неврегульована пов'язаність із юрисдикцією високого ризику утримує індекс на верхній межі діапазону У зоні ризику (34), а підтверджена шкідлива залежність чи заявлено мертвий проєкт утримують його всередині Критичного (19).
Як читати діапазони
- Діапазони навмисно грубі. Різниця між 71 і 74 — це шум; різниця між добрим та у зоні ризику — це інформація. Рішення про закупівлі та перегляд варто спирати на діапазони й на профіль категорій, а не на різницю в окремих балах. Довкола цього побудовано подання порівняння: воно заявляє розкид між записами на екрані в балах індексу, тож трибальний розрив можна розпізнати як такий і відкласти вбік.
- Діапазони діють на кожному рівні. Репозиторій може перебувати в доброму діапазоні загалом, тоді як одна з категорій — у критичному; діапазони за категоріями існують саме для того, щоб сила в одній сфері не могла непомітно приховати ризик в іншій. (Калібрування стосується загального індексу; значення категорій і метрик відображаються на ті самі пороги безпосередньо.)
- Пороги версіонуються. Межі діапазонів є частиною методології і змінюються лише з підвищенням версії, зафіксованим у кожному звіті, — див. версії методології.
Рівні сертифікації
Три діапазони вище за Помірний несуть рівні сертифікації реєстру: Certified (Добрий, оцінка A), Certified with Excellence (Відмінний, оцінка AA) та Certified AAA (Винятковий). Рівень — це діапазон, який підтверджують опубліковані свідчення, висловлений як сертифікаційний знак, — див. як рівні здобуваються і змінюються, а щодо платного шляху на замовлення — сертифікацію та ціни.
Де діапазони з'являються
Діапазони визначають колірне кодування в усьому реєстрі: картки каталогу, шкалу звіту, заголовки категорій, картки окремих метрик та бейдж для GitHub. Репозиторій, що ще не має завершеної інспекції, показує нейтральний стан очікування, а не діапазон.
Дивіться також: індекс здоров'я пояснює, як обчислюються базові значення 1–100; сигнали, а не гарантії пояснює, що вони стверджують, а що — ні.