Skip to content

Latest commit

 

History

History
109 lines (74 loc) · 2.85 KB

STYLE_GUIDE.md

File metadata and controls

109 lines (74 loc) · 2.85 KB
Raw

Guida di Stile Universale

This Style Guide is based on the Universal Style Guide

Questa Guida di Stile è basata sulla Universal Style Guide

Questa Guida di Stile descrive le regole che dovrebbero essere applicate a tutte le lingue.

NOTA PER I MANUTENTORI: Potreste voler tradurre questa guida in modo che sia più accessibile ai traduttori.

Glossario

Vedi qui

ID delle intestazioni

Tutte le intestazioni hanno degli ID espliciti, ad esempio:

## Try React {#try-react}

Non tradurre questi ID! Sono utilizzati per la navigazione e non funzioneranno più se il documento è referenziato dall'esterno.

Ad esempio, dato questo link:

See the [beginning section](/getting-started#try-react) for more information.

✅ COSÌ VA BENE:

## Prova React {#try-react}

❌ COSÌ NO:

## Prova React {#prova-react}

Nel secondo modo il link in alto non funzionerà più.

Testo nei blocchi di codice

Non tradurre il testo nei blocchi di codice, a parte i commenti. Potresti voler tradurre anche il testo delle stringhe, ma fai attenzione a non tradurre le stringhe che costituiscono riferimenti al codice!

Ad esempio:

// Example
const element = <h1>Hello, world</h1>;
ReactDOM.render(element, document.getElementById('root'));

✅ COSÌ VA BENE:

// Esempio
const element = <h1>Hello, world</h1>;
ReactDOM.render(element, document.getElementById('root'));

✅ ANCHE COSÌ:

// Esempio
const element = <h1>Ciao mondo</h1>;
ReactDOM.render(element, document.getElementById('root'));

❌ COSÌ NO:

// Esempio
const element = <h1>Ciao mondo</h1>;
// "root" fa riferimento all'ID di un elemento.
// NON TRADURLO
ReactDOM.render(element, document.getElementById('radice'));

❌ COSÌ DECISAMENTE NO:

// Esempio
const elemento = <h1>Ciao mondo</h1>;
ReactDOM.renderizza(elemento, documento.ottieniElementoDallId('radice'));

Link esterni

Se un link esterno punta ad un articolo di un riferimento come MDN o Wikipedia, ed esiste una versione di quell'articolo nella tua lingua che sia di qualità soddisfacente, puoi valutare di linkare la versione tradotta dell'articolo invece di quella originale.

Esempio:

React elements are [immutable](https://en.wikipedia.org/wiki/Immutable_object).

✅ COSÌ VA BENE:

Gli elementi di React sono [immutabili](https://it.wikipedia.org/wiki/Struttura_dati_persistente).

Per i link dei quali non esiste una versione tradotta (Stack Overflow, video di YouTube, ecc.), utilizza semplicemente il link in Inglese.