Calitatea limbajului

Terminologie și glosare.

Tratați terminologia ca conținut reglementat cu proprietari, stări, explicații aprobate și excepții controlate.

Clarificați sarcina și decizia

Acest ghid transformă terminologia și glosarele într-un flux de lucru care poate fi revizuit. Conectează deciziile de domeniu, proprietatea, dovezile și acceptarea, astfel încât rezultatul să continue să funcționeze în producție.

Tratați terminologia ca conținut reglementat cu proprietari, stări, explicații aprobate și excepții controlate.

Proces practic

  1. 1

    Definiți publicul cu dovezi, inclusiv experiență de citire, context, dispozitiv și suport disponibil.

  2. 2

    Selectați o sarcină reală și spuneți ce trebuie să înțeleagă sau să facă un cititor de succes.

  3. 3

    Creați versiunea lingvistică, păstrând în același timp fiecare fapt, condiție, dată și cale de contact relevante pentru decizie.

  4. 4

    Efectuați o revizuire de specialitate și editorială cu criterii de acceptare înregistrate.

  5. 5

    Testați cu membrii publicului vizat, înregistrați constatările, revizuiți și aprobați lansarea.

Exemplu sau instrument

O înregistrare de glosar arată termenii preferați, interziși și specifici publicului, cu îndrumarea CMS. În instrument, înregistrați, de asemenea, valoarea de bază, proprietarul, decizia, dovezile, problema deschisă și data aprobării. Utilizați o pagină reală sau o tranzacție, astfel încât echipa să vadă dependențele, excepțiile și lucrările de întreținere care urmează după lansare.

Punct de decizieÎnregistraCriteriul de acceptare
Linia de bazăStarea curentă observatăSursa și data înregistrate
DecizieOpțiunea selectată și justificareaRisc și audiență luate în considerare
DoveziTestați, documentați sau măsurațiRevizuabil și specific versiunii
AprobareNume, rol și dataToate criteriile obligatorii îndeplinite

Faceți din fiecare termen o înregistrare guvernată

Un glosar util este mai mult decât o listă de cuvinte preferate. Fiecare înregistrare trebuie să conțină un identificator stabil, termen preferat, variante interzise sau depreciate, definiție, explicație pentru public, forme gramaticale, exemple, mod de limbă, domeniu, proprietar, stare, data aprobării, sursă și declanșator de revizuire. Păstrați definiția tehnică separată de formularea prezentată cititorilor. O definiție internă precisă poate susține mai multe explicații specifice publicului, fără a permite semnificațiilor acestora să se deplaseze.

Utilizați stări explicite: propus, în curs de examinare, aprobat, depreciat și interzis. Doar înregistrările aprobate sunt oferite autorilor sau aplicate de sisteme automate. Un termen învechit rămâne căutat, astfel încât conținutul vechi poate fi găsit și migrat. Un termen interzis include motivul și înlocuirea aprobată, ceea ce îi ajută pe editori să rezolve un avertisment fără să ghicească. Versionați fiecare decizie și păstrați valoarea anterioară pentru audit și rollback.

DomeniuExempluRegula de acceptare
Termenul preferatbirou de beneficiiUn formular aprobat pentru fiecare domeniu și mod de limbă
Explicația publiculuiBiroul care verifică și vă plătește beneficiulSemnificația păstrată și testată pentru public
StareAprobatProprietar, recenzent și data înregistrate
ExcepţieTitlul formularului oficial păstrează termenul legalDomeniul de aplicare, motivul și expirarea sunt documentate

Rulați un flux de lucru repetabil de decizie pe termen

Colectați candidați din jurnalele de căutare, întrebări de asistență, comentarii ale recenzenților, modificări ale politicii și corecții manuale repetate. Înainte de a crea o înregistrare nouă, căutați termeni, variante și concepte înrudite existenți. Termenul proprietar scrie definiția și identifică sursa autorizată. Un specialist în subiect confirmă sensul, un editor propune formularea cititorului, iar un specialist în accesibilitate verifică modurile de limbă selectate. Testați explicațiile de mare impact cu cititorii vizați.

Grupul de terminologie aprobă, respinge sau solicită dovezi. Ar trebui să se întâlnească într-un program previzibil și să aibă o rută urgentă pentru modificări legale sau de serviciu. Deciziile precizează unde se aplică termenul și unde nu. De exemplu, o pagină în limbaj clar poate spune „biroul de beneficii”, în timp ce un câmp de cerere trebuie să păstreze numele autorității statutare. Excepția aparține aceleiași înregistrări, astfel încât autorii văd ambele opțiuni în context.

  1. 1

    Surprindeți termenul candidat și conținutul în care a cauzat dificultăți.

  2. 2

    Confirmați conceptul, domeniul, sursa autorizată și publicul afectat.

  3. 3

    Schiță de formulare preferată, explicație, variante și îndrumări privind migrarea.

  4. 4

    Examinați semnificația, modul de limbă, accesibilitatea și impactul operațional.

  5. 5

    Aprobați și publicați înregistrarea versiunea, apoi actualizați conținutul afectat.

Integrați terminologia în crearea și livrarea

Expuneți glosarul printr-un API sau un depozit sincronizat cu identificatori stabili. CMS ar trebui să evidențieze termenii interziși și depreciați, să arate înlocuirea și explicația preferate și să lase autorii să deschidă decizia completă. Sugestiile trebuie să respecte localitatea, domeniul, tipul de conținut și modul de limbă. Nu înlocuiți automat cuvintele atunci când gramatica sau contextul juridic poate schimba sensul. Solicitați unui autor să accepte sugestia sau să înregistreze o excepție reglementată.

Stocați versiunea glosarului utilizată pentru fiecare revizuire de limbă. Când se modifică un termen aprobat, interogați CMS înregistrările afectate și creați sarcini de revizuire în funcție de risc. Verificările de previzualizare pot bloca termeni interziși noi, explicații de prima utilizare lipsă sau o excepție expirată. Livrarea timpului de execuție nu ar trebui să depindă de o solicitare de glosar live. Rezolvați și validați termenii înainte de publicare, astfel încât o întrerupere a terminologiei să nu poată modifica sau bloca paginile publicate.

  • Sugestiile CMS folosesc identificatori de termeni stabili, mai degrabă decât potrivirea textului.

  • Localitatea, domeniul, modul de limbă și forma gramaticală sunt respectate.

  • Verificările automate explică o rezoluție în loc să raporteze doar o eroare.

  • Excepțiile au domeniul de aplicare, proprietarul, dovezile și expirarea.

  • O modificare a glosarului creează sarcini de revizuire pentru conținutul publicat afectat.

Măsurați adoptarea și rezolvați conflictele

Urmăriți utilizarea termenilor preferați, noile constatări privind termenele interzise, ​​candidații nerezolvați, timpul mediu de decizie, excepțiile expirate și conținutul care așteaptă migrare. Combinați aceste măsuri operaționale cu dovezi de înțelegere și susține cererea. O rată mare de adoptare nu dovedește că o explicație funcționează. Dacă cititorii încă înțeleg greșit un termen aprobat, redeschideți decizia și păstrați dovezile care au determinat schimbarea.

Când departamentele au nevoie de o formulare diferită, stabiliți dacă acestea înseamnă același concept. Dacă conceptul diferă, creați înregistrări legate cu domenii clare. Dacă doar publicul diferă, păstrați o definiție subiacentă și oferiți explicații separate pentru public. Atribuiți un administrator de terminologie pentru a decide disputele de proprietate și pentru a preveni duplicarea înregistrărilor. Examinați termenii cu cel mai mare impact cel puțin o dată pe an și ori de câte ori legea aplicabilă, procesul de serviciu sau standardul lingvistic selectat se modifică.

Roluri, dovezi și aprobare

Calitatea limbii este o responsabilitate operațională. Acordați proprietarului sursei responsabilitatea pentru acuratețea faptelor, unui editor responsabilitatea pentru claritate, o responsabilitate de specialitate pentru regulile de accesibilitate și un proprietar de produs responsabilitatea pentru publicare. Înregistrarea lansării ar trebui să identifice versiunea sursă, modul de limbă, examinatorii, dovezile de testare, data aprobării și evenimentul care declanșează o nouă revizuire.

Operațiuni și întreținere

Lucrarea nu se termină la publicare. Conectați versiunea sau configurația lingvistică la sursa acesteia, monitorizați măsurile de calitate și servicii și definiți declanșatorii de revizuire concreti. Declanșatorii includ modificări de sursă, modificări legale, noi nevoi de public, întrebări de asistență recurente, modificări tehnice și incidente. Un proprietar numit evaluează declanșatorul, deschide o nouă revizuire atunci când este necesar și înregistrează aprobarea reînnoită.

Listă de verificare pentru publicare

  • Audiența și sarcina sunt explicite.

  • Toate faptele juridice și operaționale se potrivesc cu sursa.

  • Datele, sumele, condițiile și excepțiile sunt complete.

  • Titlurile descriu întrebări sau acțiuni ale cititorului.

  • Linkurile și comenzile au etichete semnificative.

  • Terminologia de specialitate este explicată în mod consecvent.

  • Publicul vizat a testat călătoria critică.

  • Proprietatea și următorul declanșator de revizuire sunt înregistrate.

Surse de referință

  1. Centrul Federal de Expertiză pentru Accesibilitate - Limbă Ușoară
  2. DIN ISO 24495-1 Limbajul simplu - Principii de guvernare și linii directoare
  3. W3C - Facerea conținutului utilizabil pentru persoanele cu dizabilități cognitive și de învățare

Pune ghidul în practică

Testați Simple8 cu conținut reprezentativ și utilizați lista de verificare pentru a planifica un flux de lucru de producție controlat.

Testează-ți propriul text