Regles de suggerimentActiva

Substitució d'expressions difícils d'entendre

difficult-expressions

Localitza expressions difícils d'entendre incloses al catàleg i retorna alternatives quan n'hi ha.

Ús d’aquesta mètrica

Si està activa i troba coincidències, l’informe conté una entrada amb aquest metric_id a result.suggestions. L’absència significa que no hi ha coincidències, no que la mètrica no s’hagi avaluat.

Ubicació al resultatresult.suggestions[]metric_id = "difficult-expressions"

Mètode de càlcul

Cerca expressions completes directament sobre el text, sense distingir majúscules ni accents i respectant límits de paraula. La detecció utilitza el catàleg editorial actiu per a l'idioma.

Interpretació del resultat

Cada element d'`occurrences` identifica un fragment afectat. `start` és inclusiu i `end` exclusiu, tots dos mesurats en punts de codi Unicode sobre el text enviat. `replacement`, `alternatives` i `edits` només contenen valors quan hi ha un canvi segur; l'absència del suggeriment significa que no hi ha coincidències, no que el text sigui necessàriament correcte.

Limitacions

Depèn de la cobertura i la qualitat del catàleg actiu per a l'idioma; cada coincidència requereix revisió contextual.

Dependències

language: ca
implementation_version: 1.2

Exemple vàlid

{
  "category": "lexical",
  "examples": null,
  "explanation": null,
  "id": "sug_1",
  "implementation_version": "1.2",
  "metric_id": "difficult-expressions",
  "metric_title": "Substituci\u00f3 d\u0027expressions dif\u00edcils d\u0027entendre",
  "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/difficult-expressions

Contracte complet de peticions, respostes i errors, generat automàticament des del codi.

Consultar la fitxa JSON