Супровід пакетів перевіряє, що опублікований пакет проєкту актуальний, доступний для встановлення й не позначений застарілим у своєму реєстрі. Доглянутість у реєстрі — не те саме, що активність на GitHub: бібліотека може застаріти — або бути явно позначеною як покинута — на npm чи Packagist, поки до її репозиторію все ще надходять коміти, а користувачі встановлюють пакет, а не репозиторій.
- Категорія: Сталість та врядування (20% у межах категорії)
- Вага в загальному індексі: 4.8%
- Ключ метрики:
package_maintenance - Застосовується до: репозиторіїв, що публікують принаймні один пакет; інакше —
null
Як обчислюється значення
| Компонент | Вага | Критерії |
|---|---|---|
| Опубліковано й доступно | 25 | принаймні один із пакетів репозиторію знаходиться у своєму реєстрі |
| Свіжість публікацій | 35 | остання публікація ≤180 днів → 35 балів, ≤365 → 26, ≤730 → 14, давніше → 4 |
| Історія версій | 20 | ≥5 опублікованих версій → 20, ≥2 → 12, інакше 4 |
| Не застарілий | 20 | остання версія deprecated (npm), abandoned (Packagist) або yanked → 0; інакше 20 |
Чому важить кожен компонент
- Доступність — базова умова: пакет встановлюється з реєстру, до якого користувач реально звернеться.
- Свіжість публікацій виявляє тиху відмову: виправлення потрапляють у репозиторій, але так і не виходять — копія в реєстрі непомітно старіє, тоді як репозиторій виглядає живим.
- Історія версій відрізняє супроводжувану лінію релізів від одноразової публікації.
- Застарілість — найсильніший власний сигнал реєстру, встановлений самими мейнтейнерами; застаріла остання версія одразу обнуляє цей компонент.
Як читати результат
- Перечитуйте разом із дисципліною релізів: релізи на GitHub і публікації в реєстрі зазвичай рухаються разом, і розходження між ними саме по собі інформативне.
- Враховуються лише пакети, чиї метадані в реєстрі верифіковано вказують на інспектований репозиторій — правило зіставлення описане в підтримуваних екосистемах.
- Репозиторії, що нічого не публікують, мають тут
null, і їхня категорія перенормовується — це ніколи не штраф за те, що проєкт є застосунком.
Як покращити значення
- Публікувати релізи в реєстр як частину процесу випуску, а не заднім числом.
- Підтримувати принаймні щорічний ритм публікацій для супроводжуваних пакетів — навіть патч-реліз відновлює свіжість.
- Ніколи не залишати застарілу або відкликану (yanked) версію останньою: публікувати наступницю або знімати позначку.
Дивіться також: впровадження в екосистемі · дисципліна релізів