mirror of
https://github.com/olivierlacan/keep-a-changelog.git
synced 2025-07-29 16:54:12 +02:00
Translate
This commit is contained in:
parent
8f686de726
commit
9d28f732c8
@ -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
|
||||||
There’s 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
|
||||||
|
Loading…
x
Reference in New Issue
Block a user