Кожне значення у звіті inspect.software — компоненти, згорнуті в метрики, метрики, згорнуті в категорії, та загальний індекс здоров'я — живе на одній стандартизованій шкалі 1–100, де більше — краще. Щоб ці числа читалися з одного погляду, кожне значення відповідає одному з п'яти стандартизованих діапазонів, які послідовно застосовуються до вимірювань здоров'я, безпеки та якості.
Що означає кожен діапазон
| Діапазон | Межі | Значення |
|---|---|---|
| Відмінний | 85–100 | Взірцевий; відповідає практично всім перевіреним критеріям |
| Добрий | 70–84 | Здоровий; незначні прогалини |
| Помірний | 50–69 | Прийнятний, але з помітними прогалинами; рекомендовано перегляд |
| У зоні ризику | 30–49 | Суттєві слабкості; впровадження потребує обережності |
| Критичний | 1–29 | Серйозні проблеми — наприклад, покинутий проєкт, єдиний мейнтейнер, відсутність гігієни |
Як читати діапазони
- Діапазони навмисно грубі. Різниця між 71 і 74 — це шум; різниця між добрим та у зоні ризику — це інформація. Рішення про закупівлі та перегляд варто спирати на діапазони й на профіль категорій, а не на різницю в окремих балах.
- Діапазони діють на кожному рівні. Репозиторій може перебувати в доброму діапазоні загалом, тоді як одна з категорій — у критичному; діапазони за категоріями існують саме для того, щоб сила в одній сфері не могла непомітно приховати ризик в іншій.
- Пороги версіонуються. Межі діапазонів є частиною методології і змінюються лише з підвищенням версії, зафіксованим у кожному звіті, — див. версії методології.
Де діапазони з'являються
Діапазони визначають колірне кодування в усьому реєстрі: картки каталогу, шкалу звіту, заголовки категорій, картки окремих метрик та бейдж для GitHub. Репозиторій, що ще не має завершеної інспекції, показує нейтральний стан очікування, а не діапазон.
Дивіться також: індекс здоров'я пояснює, як обчислюються базові значення 1–100; сигнали, а не гарантії пояснює, що вони стверджують, а що — ні.