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 v2.10.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