API Docs
Reglas de sugerenciaActiva

Sustitución de expresiones difíciles de entender

difficult-expressions

Localiza expresiones difíciles de entender incluidas en el catálogo y devuelve alternativas cuando existen.

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 = "difficult-expressions"

Método de cálculo

Busca expresiones completas directamente sobre el texto, sin distinguir mayúsculas ni acentos, respetando límites de palabra. 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",
  "explanation": null,
  "id": "sug_1",
  "implementation_version": "1.2",
  "metric_id": "difficult-expressions",
  "metric_title": "Sustituci\u00f3n de expresiones dif\u00edciles de entender",
  "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."
}