La disciplina de publicación mide si un proyecto publica versiones (releases) — el mecanismo por el cual el trabajo del repositorio llega efectivamente a los usuarios. Los consumidores dependientes fijan versiones, leen los registros de cambios y actualizan en los límites de cada release; un proyecto que nunca publica versiones obliga a todos sus usuarios a depender de instantáneas sin versionar.
- Categoría: Vitalidad (40% dentro de la categoría)
- Peso en el índice general: 8,8%
- Clave de la métrica:
release_discipline
Cómo se calcula el valor
| Componente | Peso | Criterios |
|---|---|---|
| Publica versiones | 27 | cualquier release publicada; misma condición que en v0.9.0, escalada a 27 puntos |
| Recencia de las versiones | 36 | mismos umbrales que en v0.9.0, escalados a 36 puntos |
| Cadencia de publicación | 27 | mismos umbrales que en v0.9.0, escalados a 27 puntos |
| OpenSSF Scorecard: Signed-Releases | 10 | resultado 0–10 de Scorecard, escalado a 10 puntos |
Cuando los datos de releases no están disponibles, la métrica es null — se excluye de Vitalidad con renormalización de pesos, nunca se cuenta como cero. El componente de Scorecard se excluye igualmente cuando Scorecard no está disponible o informa n/a; sigue siendo además una señal plena de Seguridad.
Por qué las releases se miden aparte de los commits
La actividad de commits y la publicación son disciplinas distintas. Un repositorio puede mostrar movimiento constante en su rama predeterminada mientras los usuarios esperan un año por una release que contenga las correcciones; también existe el caso inverso — ramas tranquilas, releases puntuales. Separar la actividad de desarrollo de la disciplina de publicación hace visibles ambos patrones en lugar de permitir que uno oculte al otro.
Cómo interpretar el resultado
- La recencia es el componente de mayor peso. Un proyecto con un sólido historial de releases que dejó de publicar hace dieciocho meses puntúa sensiblemente más bajo que uno que publicó el trimestre pasado.
- La cadencia premia el ritmo, no la frecuencia por sí misma. Un ciclo trimestral constante obtiene la mayor parte de los puntos de cadencia; el nivel superior simplemente refleja los ciclos de iteración cortos habituales en bibliotecas en desarrollo activo.
- Las releases de GitHub son la fuente. Los proyectos que etiquetan versiones sin publicar releases, o que publican solo a través de un registro, pueden puntuar más bajo aquí; la recencia de publicación en el registro se mide por separado en mantenimiento de paquetes.
Cómo mejorar el valor
- Publicar las versiones mediante el mecanismo de releases del repositorio, no solo como etiquetas.
- Publicar con una cadencia predecible — las releases pequeñas y regulares puntúan mejor que las grandes y esporádicas, y por la misma razón sirven mejor a los usuarios.
- Tras cualquier periodo de inactividad, una sola release nueva restablece de inmediato el componente de recencia.
Relacionado: actividad de desarrollo · mantenimiento de paquetes