Regles de suggerimentActiva

Introducció de sigles

acronym-introduction

Detecta la primera aparició de sigles en majúscules que no semblen acompanyades pel seu desenvolupament.

Ú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 = "acronym-introduction"

Mètode de càlcul

Extreu candidats en majúscules, ignora paraules buides, conserva la primera aparició i cerca un desenvolupament adjacent abans o després.

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

És un senyal de revisió, no una correcció automàtica ni una avaluació completa de la qualitat del text.

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": "acronym-introduction",
  "metric_title": "Introducci\u00f3 de sigles",
  "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/acronym-introduction

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

Consultar la fitxa JSON