Topic: <P> Come inserire commenti nel codice di un progetto Thimble

[rancarlo]

@michro

Originale : https://support.mozilla.org/en-US/kb/how-do-i-add-code-comments-thimble-project

Traduzione: https://support.mozilla.org/it/kb/inserire-commenti-codice-thimble

[Underpass]

Più che

Commenta qui dentro

direi

Inserire qui il commento

inserire un carattere di fine riga

si capisce? Non sarebbe forse meglio

andare a capo alla fine della riga

[michro]

Eccomi

Oltre alle giuste segnalazioni di Underpass, ecco i miei suggerimenti

Sommario:

Codice: [Seleziona]

Code comments do not show up when the page is rendered, and can be a helpful way to communicate information to people remixing your project.

I commenti del codice non vengono mostrati quando la pagina viene visualizzata, sono pertanto un modo utile di dare informazioni.
Come per altri articoli che hai tradotto, più che ripetere (grosso modo) l'introduzione, spiegherei di cosa parla l'articolo in modo che chi effettua una ricerca arriva subito al sodo. Proporrei:
Questo articolo spiega come aggiungere commenti del codice nei file Html, Css e JavaScript dei progetti Thimble.

Articolo:

Code comments do not show up when the page is rendered, and can be a helpful way to communicate information to remixers, directly in the code, in context. This could include instructions for things to remix, coding tips, etc.

I commenti del codice non vengono mostrati quando la pagina viene visualizzata, sono pertanto un modo pratico di comunicare informazioni a chi si accinge a personalizzare un progetto di Thimble. Il commento è inserito direttamente nel'istruzione, nel contesto. Questo può includere instruzioni su cosa modificare, suggerimenti su come sviluppare il codice, etc.

noi, a differenza degli en-US, utilizziamo ecc.
Ti può andare bene questa mia proposta di modifica?
I commenti del codice non vengono mostrati quando la pagina viene visualizzata e possono essere pertanto un modo utile per comunicare informazioni a chi si accinge a personalizzare un progetto Thimble. I commenti vengono inseriti direttamente nel codice, nel contesto e possono includere istruzioni per le parti da personalizzare, suggerimenti su come sviluppare il codice, ecc.

Per quanto riguarda i titoli dei 3 paragrafi (metto qui solo il primo)

To add a comment to an HTML file, use this syntax
Per aggiungere un commento in un documento HTML, usare la seguente sintassi

metterei "file" al posto di "documento" (come in originale) e "utilizzare" non "usare". Idem per i titoli dei paragrafi CSS e JavaScript

[rancarlo]

Sommario

Questo articolo spiega come aggiungere commenti del codice nei file Html, Css e JavaScript dei progetti Thimble.

Visto che li sto aggiungendo, sono commenti del o commenti al ? 

Questo articolo spiega come commentare il codice nei file Html, Css e JavaScript dei progetti Thimble.  ?

I commenti del codice non vengono mostrati quando la pagina viene visualizzata e possono essere pertanto un modo utile per comunicare informazioni a chi si accinge a personalizzare un progetto Thimble. I commenti vengono inseriti direttamente nel codice, nel contesto e possono includere istruzioni per le parti da personalizzare, suggerimenti su come sviluppare il codice, ecc.

Ok

Per quanto riguarda i titoli dei 3 paragrafi (metto qui solo il primo)
To add a comment to an HTML file, use this syntax
Per aggiungere un commento in un documento HTML, usare la seguente sintassi
metterei "file" al posto di "documento" (come in originale) e "utilizzare" non "usare". Idem per i titoli dei paragrafi CSS e JavaScript

Ok

@michro
Attendo tuo ok a quanto esposto sopra per intervenire sulla traduzione.

[michro]

Dubbio più che lecito. La cosa mi era sfuggita...

Visto che li sto aggiungendo, sono commenti del o commenti al ? 

Direi "commenti nel codice" (come avevi messo anche nel titolo)
Sommario:
Questo articolo spiega come aggiungere commenti nel codice dei file Html, Css e JavaScript dei progetti Thimble.

Secondo te, a proposito di titolo (puoi ancora modificarlo personalmente visto che l'articolo non è stato ancora approvato), è meglio l'attuale titolo
Come inserire commenti nel codice di Thimble
o integrare così
Come inserire commenti nel codice di un progetto Thimble ?

In ogni caso come slug utilizzerei: inserire-commenti-codice-thimble

Vedi di applicare anche i suggerimenti di Underpass.

Ti volevo far notare una cosa. Nel campo di modifica dell'articolo, nel paragrafo
==Per un commento in un documento CSS, usare la seguente sintassi==
credo tu abbia notato che

Codice: [Seleziona]

/* Commenta qui dentro */ (che dovrai modificare come suggerito da Underpass) è bordato/evidenziato in nero.
Significa che c'è uno spazio in eccesso prima di /* Commenta qui dentro */, spazio che devi togliere e vedrai che l'evidenziazione sparisce. Non è colpa tua, è un errore del sorgente originale en-US

[rancarlo]

si capisce? Non sarebbe forse meglio

andare a capo alla fine della riga

Ok

Sommario:
Questo articolo spiega come aggiungere commenti nel codice dei file Html, Css e JavaScript dei progetti Thimble.

Ok

Come inserire commenti nel codice di un progetto Thimble

In ogni caso come slug utilizzerei: inserire-commenti-codice-thimble

Ok michro una domanda, lo slug ha altre funzioni oltre a quelle evidenti di essere un URL e standardizzarne la composizione abbreviando?

Significa che c'è uno spazio in eccesso prima di /* Inserire qui il commento */,

Ok, non mi ero reso conto di come farlo scomparire.

[michro]

Ok michro una domanda, lo slug ha altre funzioni oltre a quelle evidenti di essere un URL e standardizzarne la composizione abbreviando?

No, non ha altre funzioni. Serve solo a reindirizzare all'articolo a cui è associato
Qui c'è una breve spiegazione: https://support.mozilla.org/it/kb/tradurre-articolo#w_che-cosa-si-deve-tradurre

[rancarlo]

https://support.mozilla.org/it/kb/inserire-commenti-codice-thimble/revision/135581

[rancarlo]

https://support.mozilla.org/it/kb/inserire-commenti-codice-thimble/revision/135582

[rancarlo]

@michro, questo passaggio su https://support.mozilla.org/it/kb/tradurre-articolo#w_che-cosa-si-deve-tradurre non mi è chiaro, mi aiuti a capire?

Ricordarsi di mantenere inalterata la posizione del marcatore dell'Indice dei contenuti (se presente nell'articolo). Si tratta di questo tipo di dicitura: __TOC__

[michro]

Last????
Cerca di variare i commenti alle diverse revisioni mettendo una breve descrizione tipo "QA Underpass", "Sommario e titoli paragrafi" o simili, altrimenti che storico è?
Queste sono le ultime modifiche che devi fare così poi approviamo.

==Per aggiungere un commento in un file HTML, utilizzare la seguente sintassi==

<code><<!-- -->!--Inserire qui il commento--> <!-- --></code>

==Per aggiungere un commento in un file CSS, utilizzare la seguente sintassi==

/* Inserire qui il commento */

==Per aggiungere un commento su una singola riga in un file JavaScript, utilizzare la seguente sintassi==

// Inserire qui il commento [assicurarsi di andare a capo alla fine della riga]

<code><<!-- -->!-- Inserire qui il commento --> <!-- --></code>
va messo senza spazi tra i due trattini -- prima di Inserire e quelli dopo commento, così:
<<!-- -->!--Inserire qui il commento-->--> <!-- -->

Strano che non abbiano messo anche i commenti su più righe. Ma non è un nostro problema

[rancarlo]

Last???

autoironia!!

Quando esci ricordati di chiudere la porta!!

Non mi fa entrare!! @michro ooooo

[michro]

Ok, sono uscito! Ho chiuso la porta. Stavo verificando una cosa nella sintassi della traduzione

@michro, questo passaggio su https://support.mozilla.org/it/kb/tradurre-articolo#w_che-cosa-si-deve-tradurre non mi è chiaro, mi aiuti a capire?

Ricordarsi di mantenere inalterata la posizione del marcatore dell'Indice dei contenuti (se presente nell'articolo). Si tratta di questo tipo di dicitura: __TOC__

Negli articoli che hai tradotto il __TOC__ non c'è perché non hanno inserito un indice dei contenuti negli articoli Thimble.
"TOC" è l'acronimo di "Table Of Contents" che noi abbiamo tradotto come "Indice dei contenuti".

Negli articoli per Firefox invece viene utilizzato quasi sempre. Ti faccio un esempio concreto con un articolo a caso.
Questo è l'articolo
https://support.mozilla.org/it/kb/risolvere-errori-data-ora-siti-web-sicuri
noterai che dopo l'introduzione c'è un riquadro in grigio con un testo all'interno
Indice dei contenuti
e in azzurro ci sono i titoli dei paragrafi che compongono l'articolo (sono dei link che se "cliccati" portano esattamente al paragrafo e vengono utilizzati come àncore per andare a quello specifico paragrafo quando quei link vengono utilizzati in un altro articolo... ma procediamo con una questione per volta per non creare confusione)

Quel riquadro e quel testo vengono creati automaticamente quando si utilizza l'istruzione __TOC__

Adesso fai clic su "Sorgente della versione" qui
https://support.mozilla.org/it/kb/risolvere-errori-data-ora-siti-web-sicuri/revision/135092
potrai visualizzare il sorgente e noterai che all'interno non compare né la scritta "Indice dei contenuti" né i link con i titoli dei paragrafi ma compare semplicemente il __TOC__

Se tu per sbaglio elimini il __TOC__, nell'articolo il riquadro e i link spariscono e se lo sposti in un'altra posizione (ad esempio dopo un paragrafo) l'articolo risulta "sballato".
Spero di essere stato comprensibile.

Puoi anche fare un test. Prova a entrare in modifica in questo articolo Thimble, inserisci __TOC__ tra l'introduzione e il titolo paragrafo ==Per aggiungere un commento in un file HTML, utilizzare la seguente sintassi== poi fai clic su "Anteprima dei contenuti" e vedrai cosa ti compare... Naturalmente poi non salvare la modifica facendo clic su "Proponi per revisione"

[rancarlo]

https://support.mozilla.org/it/kb/inserire-commenti-codice-thimble/revision/135588

[michro]

Ti tiro le orecchie!!!
Dai che voglio andare a dormire che domani ho una giornatina...

Codice: [Seleziona]

==To add a single-line comment to a JavaScript file, use this syntax==
==Per una linea di commento in un file JavaScript, utilizzare la seguente sintassi==
==Per aggiungere un commento su una singola riga in un file JavaScript, utilizzare la seguente sintassi==