Conceptos

Configuración de la inspección

Cómo pueden desactivarse partes de la metodología de inspect.software por cada inspección — y cómo cada informe documenta exactamente qué se midió y qué no.

Metodología v1.13.0Actualizado el 2026-07-13

Una inspección puede desactivar cualquier parte de la metodología — un componente concreto, una métrica completa o una categoría entera. Esto existe para acotaciones legítimas (una política interna que excluye las señales de popularidad, una certificación exclusivamente de seguridad) manteniendo honesto cada resultado publicado: la configuración queda incorporada en el propio informe, de modo que siempre es explícito qué se midió y qué no.

Cómo funciona la desactivación

La desactivación se comporta exactamente igual que los datos ausentes (véase el índice de salud): el elemento desactivado se excluye y los pesos restantes se renormalizan. El resultado permanece en la escala 1–100 y nunca queda lastrado por un cero correspondiente a algo que deliberadamente no se midió. Desactivar todas las métricas de una categoría — o la categoría misma — retira esa categoría del índice general, con su peso redistribuido.

// scan-config.json
{
  "disabled_categories": ["security"],
  "disabled_metrics": ["popularity"],
  "disabled_components": {
    "documentation": ["Wiki", "Topics"]
  }
}

Las claves de categoría y de métrica son los identificadores documentados en cada artículo del wiki (security, popularity, security_posture, …); los nombres de componente son los nombres visibles exactos que se muestran en las tarjetas de métrica (Wiki, Stars, README, …). Las claves desconocidas se informan como advertencias y se ignoran.

Lo que la configuración no puede hacer

La configuración selecciona qué partes de la metodología fija están activas — nunca cambia una fórmula, un peso ni un umbral de banda. Todo ello sigue regido por la metodología versionada (véase versiones de la metodología). No existe mecanismo alguno, de pago o de otro tipo, para ajustar cómo se calcula una métrica activa.

Cómo se lee una inspección configurada

  • Cada informe lleva su configuración en el nivel superior, de modo que el resultado es reproducible tal como se publicó.
  • El informe muestra una sección de configuración de la inspección que enumera todo lo desactivado — o declara que se ejecutó la metodología completa.
  • La note de cada métrica afectada deja constancia de la renormalización, en el lugar exacto donde un lector la buscaría.
Regla de transparencia. Una inspección acotada es una medición válida de una pregunta más acotada — y el informe siempre indica qué pregunta se formuló.

Relacionado: el índice de salud · señales, no garantías