Translate

This commit is contained in:
Michele Castoldi 2017-06-26 20:28:17 +02:00 committed by GitHub
parent 8f686de726
commit 9d28f732c8

View File

@ -20,7 +20,7 @@ version: 1.0.0
.header .header
.title .title
%h1 Tenere un Changelog %h1 Tenere un Changelog
%h2 Non lasciare che i tuoi amici facciano copia incolla dei git logs nei changelogs. %h2 Non lasciare che i tuoi amici facciano copia incolla dei git logs nei changelog.
= link_to changelog do = link_to changelog do
Versione Versione
@ -34,7 +34,7 @@ version: 1.0.0
Cos'è un changelog? Cos'è un changelog?
%p %p
Un change log è un file che contiene una lista curata e ordinata cronologicamente Un changelog è un file che contiene una lista curata e ordinata cronologicamente
delle modifiche degne di nota per ogni versione di un progetto. delle modifiche degne di nota per ogni versione di un progetto.
%h3#why %h3#why
@ -124,14 +124,14 @@ version: 1.0.0
.bad-practices .bad-practices
%h3#bad-practices %h3#bad-practices
%a.anchor{ href: "#bad-practices", aria_hidden: "true" } %a.anchor{ href: "#bad-practices", aria_hidden: "true" }
I changelogs possono essere cattivi? I changelog possono essere cattivi?
%p Si. Ecco alcuni modi in cui possono essere meno utili. %p Si. Ecco alcuni modi in cui possono essere meno utili.
%h4#log-diffs %h4#log-diffs
%a.anchor{ href: "#log-diffs", aria_hidden: "true" } %a.anchor{ href: "#log-diffs", aria_hidden: "true" }
Commit log diffs Commit log diffs
%p %p
Usare commit log diffs al posto dei changelogs è una brutta idea: contengono solo cose superflue. Usare commit log diffs al posto dei changelog è una brutta idea: contengono solo cose superflue.
Come come merge commits, commits con titoli oscuri, Come come merge commits, commits con titoli oscuri,
modifiche della documentazione, etc. modifiche della documentazione, etc.
@ -147,77 +147,77 @@ version: 1.0.0
%a.anchor{ href: "#ignoring-deprecations", aria_hidden: "true" } %a.anchor{ href: "#ignoring-deprecations", aria_hidden: "true" }
Ignorare le Deprecazioni Ignorare le Deprecazioni
%p %p
When people upgrade from one version to another, it should be Quando le persone aggiornano da una versione ad un'altra,
painfully clear when something will break. It should be possible to dovrebbe essere dolorosamente chiaro quando qualcosa si romperà.
upgrade to a version that lists deprecations, remove what's Dovrebbe essere possibile eseguire l'aggiornamento a una versione
deprecated, then upgrade to the version where the deprecations che elenca le deprecazioni, rimuove ciò che è deprecato, quindi
become removals. aggiorna alla versione in cui le deprecazioni diventano rimozioni.
%p %p
If you do nothing else, list deprecations, removals, and any Se non fai nient'altro elenca le deprecazioni, le rimozioni e
breaking changes in your changelog. qualsiasi altro cambiamento nel tuo changelog.
%h4#confusing-dates %h4#confusing-dates
%a.anchor{ href: "#confusing-dates", aria_hidden: "true" } %a.anchor{ href: "#confusing-dates", aria_hidden: "true" }
Confusing Dates Confusione delle date
%p %p
In the U.S., people put the month first (<code>06-02-2012</code> for Negli Stati Uniti si mette prima il mese nelle date (<code>06-02-2012</code> sta per
June 2nd, 2012), while many people in the rest of the world write a il 2 Giugno 2012), mentre molte persone nel resto del mondo scrivono un
robotic-looking <code>2 June 2012</code>, yet pronounce it robotico <code>2 June 2012</code>, ma lo pronunciano diversamente.
differently. <code>2012-06-02</code> works logically from largest to <code>2012-06-02</code> funziona con la logica dal più grande al più piccolo,
smallest, doesn't overlap in ambiguous ways with other date formats, non ha sovrapposizioni ambigue con altri formati di date, ed è uno #{link_to "ISO standard", iso}.
and is an #{link_to "ISO standard", iso}. Thus, it is the Per tutti questi motivi, è il formato di date raccomandato per i changelog.
recommended date format for changelogs.
%aside %aside
Theres more. Help me collect these antipatterns by C'è di più. Aiutatemi a collezionare questi anti-modelli
= link_to "opening an issue", issues = link_to "aprendo un issue", issues
or a pull request. o una pull request.
.frequently-asked-questions .frequently-asked-questions
%h3#frequently-asked-questions %h3#frequently-asked-questions
%a.anchor{ href: "#frequently-asked-questions", aria_hidden: "true" } %a.anchor{ href: "#frequently-asked-questions", aria_hidden: "true" }
Frequently Asked Questions Domande frequenti
%h4#standard %h4#standard
%a.anchor{ href: "#standard", aria_hidden: "true" } %a.anchor{ href: "#standard", aria_hidden: "true" }
Is there a standard changelog format? Esiste un formato standard per i changelog?
%p %p
Not really. There's the GNU changelog style guide, or the two- Non esattamente. Esistono le linee guida GNU sullo stile dei changelog, oppure
paragraph-long GNU NEWS file "guideline". Both are inadequate or i due lunghi paragrafi nel documento di GNU NEWS denominato "guideline". Entrambe
insufficient. sono inadeguate o insufficienti.
%p %p
This project aims to be Questo progetto vuole essere
= link_to "a better changelog convention.", changelog = link_to "una migliore convenzione per i file changelog.", changelog
It comes from observing good practices in the open source Per questo motivo osserviamo le migliori pratiche della comunità open source
community and gathering them. e le portiamo avanti.
%p %p
Healthy criticism, discussion and suggestions for improvements Critiche, discussioni e suggerimenti per migliorare
= link_to "are welcome.", issues = link_to "sono ben accetti.", issues
%h4#filename %h4#filename
%a.anchor{ href: "#filename", aria_hidden: "true" } %a.anchor{ href: "#filename", aria_hidden: "true" }
What should the changelog file be named? Come si dovrebbe chiamare il file di changelog?
%p %p
Call it <code>CHANGELOG.md</code>. Some projects use Chiamalo <code>CHANGELOG.md</code>. Alcuni progetti usano anche
<code>HISTORY</code>, <code>NEWS</code> or <code>RELEASES</code>. <code>HISTORY</code>, <code>NEWS</code> o <code>RELEASES</code>.
%p %p
While it's easy to think that the name of your changelog file Mentre è facile pensare che il nome del tuo file changelog
doesn't matter that much, why make it harder for your end users to non sia poi così importante, perchè non rendere facile la
consistently find notable changes? vita ai tuoi utenti, usando sempre lo stesso nome?
%h4#github-releases %h4#github-releases
%a.anchor{ href: "#github-releases", aria_hidden: "true" } %a.anchor{ href: "#github-releases", aria_hidden: "true" }
What about GitHub Releases? Cosa dire delle GitHub Releases?
%p %p
It's a great initiative. #{link_to "Releases", ghr} can be used to È una bella iniziativa. #{link_to "Releases", ghr} può essere usato
turn simple git tags (for example a tag named <code>v1.0.0</code>) per rendere semplice i git tags (per esempio il nome del tag <code>v1.0.0</code>)
into rich release notes by manually adding release notes or it can All'interno di note di rilascio ben dettagliate si possono aggiungere le note manualmente oppure è possibile
pull annotated git tag messages and turn them into notes. utilizzare le note dei messaggi dei git tag inserendole dentro nelle note di rilascio.
j
%p %p
GitHub Releases create a non-portable changelog that can only be GitHub Releases create a non-portable changelog that can only be
displayed to users within the context of GitHub. It's possible to displayed to users within the context of GitHub. It's possible to