# Referencia de métricas y clasificaciones

Comprenda la terminología utilizada por GitHub para evaluar la calidad del código del repositorio.

> \[!NOTE]
> GitHub Code Quality está actualmente en versión preliminar pública y sujeto a cambios.
> Durante versión preliminar pública, Code Quality no se facturará, aunque los escaneos de Code Quality consumirán minutos de GitHub Actions.

En este artículo se proporcionan definiciones para las métricas y clasificaciones usadas por Code Quality.

Puede ver los resultados basados en reglas para su repositorio en la pestaña **<svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-shield" aria-label="shield" role="img"><path d="M7.467.133a1.748 1.748 0 0 1 1.066 0l5.25 1.68A1.75 1.75 0 0 1 15 3.48V7c0 1.566-.32 3.182-1.303 4.682-.983 1.498-2.585 2.813-5.032 3.855a1.697 1.697 0 0 1-1.33 0c-2.447-1.042-4.049-2.357-5.032-3.855C1.32 10.182 1 8.566 1 7V3.48a1.75 1.75 0 0 1 1.217-1.667Zm.61 1.429a.25.25 0 0 0-.153 0l-5.25 1.68a.25.25 0 0 0-.174.238V7c0 1.358.275 2.666 1.057 3.86.784 1.194 2.121 2.34 4.366 3.297a.196.196 0 0 0 .154 0c2.245-.956 3.582-2.104 4.366-3.298C13.225 9.666 13.5 8.36 13.5 7V3.48a.251.251 0 0 0-.174-.237l-5.25-1.68ZM8.75 4.75v3a.75.75 0 0 1-1.5 0v-3a.75.75 0 0 1 1.5 0ZM9 10.5a1 1 0 1 1-2 0 1 1 0 0 1 2 0Z"></path></svg> Security and quality**, debajo de la pestaña **Conclusiones estándar** "<svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-code-review" aria-label="code review" role="img"><path d="M1.75 1h12.5c.966 0 1.75.784 1.75 1.75v8.5A1.75 1.75 0 0 1 14.25 13H8.061l-2.574 2.573A1.458 1.458 0 0 1 3 14.543V13H1.75A1.75 1.75 0 0 1 0 11.25v-8.5C0 1.784.784 1 1.75 1ZM1.5 2.75v8.5c0 .138.112.25.25.25h2a.75.75 0 0 1 .75.75v2.19l2.72-2.72a.749.749 0 0 1 .53-.22h6.5a.25.25 0 0 0 .25-.25v-8.5a.25.25 0 0 0-.25-.25H1.75a.25.25 0 0 0-.25.25Zm5.28 1.72a.75.75 0 0 1 0 1.06L5.31 7l1.47 1.47a.751.751 0 0 1-.018 1.042.751.751 0 0 1-1.042.018l-2-2a.75.75 0 0 1 0-1.06l2-2a.75.75 0 0 1 1.06 0Zm2.44 0a.75.75 0 0 1 1.06 0l2 2a.75.75 0 0 1 0 1.06l-2 2a.751.751 0 0 1-1.042-.018.751.751 0 0 1-.018-1.042L10.69 7 9.22 5.53a.75.75 0 0 1 0-1.06Z"></path></svg> Calidad del código".

## Definiciones de métricas

En la tabla siguiente se proporcionan definiciones para cada métrica que se notifica para tu repositorio.

| Métrica           | Definición                                                                                                                                                                                                                                                          | Resultados de ejemplo                                                                                                                                                  |
| ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Reliability**   | Evalúe si el código realiza su función prevista correctamente, de forma predecible y coherente. El código confiable está libre de errores, controla los errores de forma segura y funciona según lo previsto en condiciones normales y de casos perimetrales.       | Problemas con el rendimiento, simultaneidad, control de errores, corrección, diseño de API, accesibilidad, internacionalización o seguridad                            |
| **Mantenimiento** | Evalúe lo fácil que es comprender, modificar y ampliar el código a lo largo del tiempo. El código que se puede mantener sigue los procedimientos recomendados, evita la complejidad innecesaria y se organiza para facilitar los cambios futuros y la colaboración. | No usar procedimientos recomendados, código no usado o inactivo, código duplicado, complejidad, redundancia lógica, documentación inadecuada, problemas de dependencia |

## Niveles de gravedad

Los niveles de gravedad se usan para indicar el impacto potencial o la urgencia de un hallazgo de calidad de código. Ayudan a los usuarios a priorizar los esfuerzos de corrección y a comunicar riesgos a las partes interesadas. La gravedad viene determinada por la regla que detectó el problema, siguiendo las convenciones de CodeQL y los estándares del sector.

| Severity        | Definición                                                                                                                                                   |
| --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Error**       | Indica un problema de alta gravedad que es probable que cause errores, errores o riesgos de mantenimiento importantes.                                       |
| **Advertencia** | Indica un problema de gravedad moderada que puede afectar a la calidad o confiabilidad del código, pero no es inmediatamente crítico.                        |
| **Nota**        | Indica un problema de gravedad baja, una mejora menor o una recomendación. Estos hallazgos son útiles para la salud y el mantenimiento continuos del código. |

## Definiciones de clasificaciones

Estas clasificaciones se usan para resumir la confiabilidad general y la capacidad de mantenimiento de un repositorio en función de la gravedad de los resultados basados en reglas encontrados por CodeQL exámenes de la rama predeterminada completa:

| Rating              | Definición                                                                                                 | Criterios (basados en las conclusiones)           |
| ------------------- | ---------------------------------------------------------------------------------------------------------- | ------------------------------------------------- |
| **Excelente**       | Codebase muestra los procedimientos recomendados para la confiabilidad y el mantenimiento.                 | No se detectaron resultados de calidad del código |
| **Bien**            | El código base tiene problemas de gravedad baja o se sugieren mejoras menores.                             | ≥1 Hallazgo de nivel "Nota" ≥1                    |
| **Bueno**:          | Codebase tiene problemas de gravedad moderada que pueden afectar a la calidad, pero no son críticos.       | ≥1 hallazgo de nivel "Advertencia"                |
| **Necesita mejora** | El código base tiene problemas de alta gravedad, incluidos errores o riesgos de mantenimiento importantes. | ≥1 Hallazgo de nivel "Error"                      |

## Lectura adicional

* [Acerca de la calidad del código de GitHub](/es/code-security/code-quality/concepts/about-code-quality)
* [Análisis de los resultados de calidad del código para tu repositorio](/es/code-security/code-quality/how-tos/interpret-results)