Un flux de localització al català que es pugui revisar

1. Acorda l’abast i un glossari petit

Abans de demanar una traducció a un agent, indica qui llegirà el text i on apareixerà. No és el mateix un botó curt que una guia d’instal·lació. Decideix el tractament, el to i termes recurrents com ara «fitxer», «repositori» i «instal·lar». Conserva els noms de producte i les ordres de la CLI.

Defineix quins textos queden fora de l’abast: codi, identificadors, slugs, llicències i contingut d’autors tercers sense permís per modificar-lo. A SkillsCat, seleccionar Català canvia la interfície i els recursos propis disponibles, no la llengua original de tots els skills.

2. Protegeix l’estructura i tradueix amb context

Treballa sobre una còpia o una branca de revisió. Passa a l’agent només els fitxers necessaris i no hi incloguis secrets ni dades personals. Dona-li el context de cada cadena, la longitud aproximada i una captura o descripció del lloc on es mostrarà.

Les variables com {count}, les rutes i les marques de format han de conservar-se. També cal revisar plurals, accents, apòstrofs i el punt volat de paraules com «instal·lació». Evita substituir fragments de frases: l’ordre de les paraules pot variar segons la llengua.

Text d’origen (plural): Install {count} skills
Proposta (plural): Instal·la {count} skills
No tradueixis: {count}, SKILL.md, --agent, /api/search

3. Prova el flux, no només les cadenes

Comprova que les claus i les variables coincideixen amb el catàleg original. Després obre la interfície: els textos més llargs poden tallar-se en pantalles petites. Verifica la navegació amb teclat, les etiquetes accessibles i els missatges d’error, càrrega i resultats buits.

Prova l’entrada directa a una adreça URL en català, una recàrrega i el canvi de llengua dins d’una pàgina amb paràmetres o una àncora. Una bona traducció no serveix de gaire si un enllaç et retorna inesperadament a una altra llengua.

• Comprova dates i nombres amb la configuració regional ca, sense modificar dades originals.
• Llegeix les ordres copiades de la documentació: només el text explicatiu ha de canviar.
• Prova una pantalla estreta i text ampliat; els controls han de continuar sent llegibles.
• Distingeix el text propi traduït del contingut original d’un skill de tercers.

4. Demana revisió i documenta els límits

Una comprovació automàtica detecta variables perdudes, però no tots els errors de sentit o naturalitat. Demana a una persona competent en català que revisi terminologia, coherència i adequació al públic. Marca les cadenes pendents de revisió en lloc d’afirmar que tot està validat.

Per proposar una correcció a SkillsCat, inclou l’URL, el text actual, la proposta i una breu explicació. No cal justificar l’ús del català: l’objectiu és que els recursos siguin útils. Si un terme admet variants, explica el context perquè la decisió no es redueixi a una substitució mecànica.

Continua aprenent

Consulta la guia de la CLI o torna als tutorials en català.

Revisió lingüística per persones catalanoparlants pendent. Proposa una correcció amb l’URL i el fragment afectat. No incloguis credencials ni dades privades.