Reglas de sugerenciaActiva

Uso de definiciones

definition-usage

Compara el número de indicadores de definición del texto con el valor de referencia del género textual.

Uso de esta métrica

Si está activa y encuentra coincidencias, el informe contiene una entrada con este metric_id en result.suggestions. Su ausencia significa que no hubo coincidencias, no que la métrica no se evaluara.

Ubicación en el resultadoresult.suggestions[]metric_id = "definition-usage"

Método de cálculo

Cuenta los marcadores de definición del texto y los compara con el valor de referencia del género; el parámetro de modo decide si el aviso se emite por exceso o por defecto. La detección utiliza el catálogo editorial activo para el idioma.

Interpretación del resultado

Cada elemento de `occurrences` identifica un fragmento afectado. `start` es inclusivo y `end` exclusivo, ambos medidos en puntos de código Unicode sobre el texto enviado. `replacement`, `alternatives` y `edits` solo aparecen con contenido cuando existe un cambio seguro; la ausencia de esta sugerencia significa que no hubo coincidencias, no que el texto sea necesariamente correcto.

Limitaciones

Depende de la cobertura y calidad del catálogo activo para el idioma; una coincidencia requiere revisión contextual.

Dependencias

language: es
implementation_version: 1.2

Ejemplo válido

{
  "category": "lexical",
  "examples": null,
  "explanation": null,
  "id": "sug_1",
  "implementation_version": "1.2",
  "metric_id": "definition-usage",
  "metric_title": "Uso de definiciones",
  "occurrences": [
    {
      "alternatives": [],
      "edits": [],
      "end": 25,
      "id": "occ_1",
      "paragraph_index": 0,
      "replacement": null,
      "sentence_index": 0,
      "start": 18,
      "text": "example"
    }
  ],
  "recommendations": [
    "Review the detected fragment in context."
  ],
  "severity": "warning",
  "summary": "Example detection returned by this metric."
}

GET /v1/metrics/definition-usage

Contrato completo de solicitudes, respuestas y errores, generado automáticamente desde el código.

Consultar ficha JSON