Come revisionare termini tecnici, maiuscole ed etichette tradotte
Quando revisioni la documentazione tecnica, confronta ogni termine con una tabella terminologica esplicita anziché affidarti alla memoria o a una singola regola sull'uso delle maiuscole. Registra la forma approvata, l'ortografia e l'uso di maiuscole/minuscole che i lettori dovrebbero vedere, le varianti accettabili, il codice letterale o gli identificatori API e qualsiasi traduzione ancora in attesa di decisione. Poi rileggi il testo discorsivo, le etichette dell'interfaccia e gli identificatori come elementi distinti. Questo metodo individua le incongruenze terminologiche preservando i nomi e il codice che devono rimanere esatti.
Perché una sola regola sulle maiuscole non può risolvere ogni termine?
Le guide di stile offrono impostazioni predefinite utili, ma un prodotto o un dominio specifico possono avere nomi consolidati che richiedono un trattamento diverso. La guida per gli sviluppatori di Google raccomanda l'uso standard delle maiuscole dell'inglese americano e il sentence case per titoli, elenchi e tabelle, preservando al contempo i nomi ufficiali dei prodotti e le forme del codice. Anche la guida di Microsoft privilegia le maiuscole in stile frase (sentence case), ma riserva esplicitamente le maiuscole ai nomi propri come i suoi marchi, prodotti e servizi. Il loro standard condiviso è un punto di partenza, non la prova che un determinato termine tecnico sia generico. [Guida all'uso delle maiuscole di Google](https://developers.google.com/style/capitalization) [Guida all'uso delle maiuscole di Microsoft](https://learn.microsoft.com/en-us/style-guide/capitalization)
Un elenco di termini (word list) può rispondere a una domanda diversa rispetto a una pagina generale sulle maiuscole: quale ortografia o uso preferisce una particolare guida editoriale per termini specifici. L'elenco di parole di Google, ad esempio, rimanda i lettori al dizionario preferito per le voci non trattate e distingue le indicazioni di stile dalla verifica di una definizione tecnica nella documentazione autorevole. Tale separazione è utile: la coerenza editoriale e la correttezza tecnica necessitano di prove provenienti da fonti adeguate a ciascuna domanda. [Elenco di termini di Google](https://developers.google.com/style/word-list)
Cosa deve contenere una tabella terminologica per la revisione?
Crea una riga per ogni termine che potrebbe essere modificato in modo incoerente o tradotto erroneamente. Questo esempio ipotetico mostra i campi e la logica decisionale; «Sync token» e la sua traduzione sono a scopo illustrativo, non affermazioni relative a un prodotto reale o a una terminologia approvata.
Il compito della tabella è preservare le decisioni e i loro limiti. Una forma minuscola consentita non dovrebbe diventare silenziosamente un secondo nome di prodotto; un identificatore non dovrebbe essere «corretto» per adattarsi al testo discorsivo; e una traduzione non risolta dovrebbe rimanere visibilmente tale. Quando una fonte ufficiale è in conflitto con un glossario locale, registra il conflitto e la fonte della decisione finale anziché unire le forme in un elenco non commentato.
Come si decidono l'ortografia e le maiuscole da visualizzare?
Innanzitutto identifica a cosa si riferisce il termine: un concetto comune, un marchio o nome di prodotto, un'etichetta dell'interfaccia utente o un identificatore letterale. Controlla la documentazione pertinente del prodotto o il glossario per individuare la forma ufficiale. Quindi applica le regole di stile della pubblicazione di destinazione al testo ordinario, ai titoli e alle etichette, mantenendo le eccezioni documentate per nomi e identificatori. Google sconsiglia le maiuscole non necessarie e mette in guardia dall'utilizzare solo la combinazione maiuscola/minuscola per distinguere i significati; analogamente, Microsoft indica di usare le minuscole tranne che all'inizio delle frasi e per i nomi propri nel suo approccio sentence-style. [Guida all'uso delle maiuscole di Google](https://developers.google.com/style/capitalization) [Guida all'uso delle maiuscole di Microsoft](https://learn.microsoft.com/en-us/style-guide/capitalization)
Successivamente, confronta la forma con l'elenco dei termini e il dizionario dell'organizzazione di destinazione, ove opportuno. Annota la fonte e la sua versione o la data di verifica, in modo che un altro redattore possa ricostruire la scelta. Non dedurre l'ufficialità dall'aspetto gradevole di una grafia con maiuscole, da un risultato di ricerca o da una traduzione che assomiglia al termine inglese. Se le fonti non concordano o non specificano la forma, contrassegna la riga per una decisione anziché presentare un'ipotesi come terminologia consolidata.
Come verificare le traduzioni e le etichette dell'interfaccia?
Tratta la traduzione come una decisione legata al significato e al contesto, non come una conversione meccanica delle maiuscole. Un'etichetta può essere vincolata dall'interfaccia, dalla terminologia consolidata del prodotto localizzato o da una diversa struttura grammaticale nella lingua di destinazione. Confronta la proposta con i materiali localizzati approvati e con il contesto in cui i lettori la troveranno. Se non è disponibile alcuna forma localizzata autorevole, contrassegna la traduzione come non risolta e richiedi una decisione terminologica adeguata; non inventare un equivalente apparentemente ufficiale.
Dopo aver deciso il termine, revisiona l'etichetta effettiva nel suo contesto visivo. Verifica se l'uso delle maiuscole segue le regole della lingua prescelta e lo stile applicabile al prodotto o all'azienda. Mantieni visibile l'etichetta originale nella scheda del termine, insieme alla fonte e allo stato, affinché una revisione futura non scambi una traduzione provvisoria per una approvata. Se l'etichetta è citata anche nelle istruzioni procedurali, verifica che il testo riporti esattamente le stesse parole visualizzate sullo schermo.
Come si proteggono il codice e gli identificatori API?
Separa le stringhe letterali dal testo editoriale prima di modificare le maiuscole. Confronta gli identificatori carattere per carattere con la documentazione API di riferimento, lo schema, il codice o l'interfaccia. Mantieni trattini bassi, maiuscole, spaziature e punteggiatura laddove definiti dalla fonte; la normalizzazione stilistica appartiene alla spiegazione circostante, non a un valore letterale. La guida di Google consente espressamente forme tutte in maiuscolo o in camel-case nei nomi ufficiali o quando si fa riferimento a codice che le utilizza. [Guida all'uso delle maiuscole di Google](https://developers.google.com/style/capitalization)
Una revisione pratica contrassegna gli identificatori protetti nella tabella terminologica e poi verifica ogni occorrenza rispetto a tale riferimento. Se una frase usa un termine in formato codice come un sostantivo comune, decidi se spiegarlo con parole più accessibili per il lettore mantenendo intatto l'identificatore letterale nella formattazione di codice. Quando la definizione autorevole stessa non è chiara, registra l'incertezza: una guida di stile non può determinare il comportamento di un'API o il nome canonico di un campo.
Qual è una sequenza di revisione affidabile?
Questa sequenza è un supporto per la revisione, non una traduzione automatica o una regola universale sulle maiuscole. Il suo valore risiede nel rendere esaminabile ogni decisione editoriale: quale forma è stata scelta, da dove proviene, dove si applica e cosa richiede ancora una decisione. Per un documento breve, può bastare una tabella compatta; per un ampio corpus terminologico, conserva gli stessi campi all'interno del flusso di lavoro del glossario adottato dal team.