mirror of
https://github.com/olivierlacan/keep-a-changelog.git
synced 2025-07-31 01:34:18 +02:00
Completed a superficial translation
This commit is contained in:
parent
9d28f732c8
commit
aae188a899
@ -219,83 +219,79 @@ version: 1.0.0
|
|||||||
utilizzare le note dei messaggi dei git tag inserendole dentro nelle note di rilascio.
|
utilizzare le note dei messaggi dei git tag inserendole dentro nelle note di rilascio.
|
||||||
j
|
j
|
||||||
%p
|
%p
|
||||||
GitHub Releases create a non-portable changelog that can only be
|
GitHub Releases crea un changelog non-portable che può essere solo
|
||||||
displayed to users within the context of GitHub. It's possible to
|
visualizzato dagli utenti nel contesto di GitHub. È possibile farlo
|
||||||
make them look very much like the Keep a Changelog format, but it
|
apparire molto simile al formato di Keep a Changelog, tuttavia tende
|
||||||
tends to be a bit more involved.
|
ad essere un po' più complicato.
|
||||||
%p
|
%p
|
||||||
The current version of GitHub releases is also arguably not very
|
La versione corrente di GitHub Releases risulta inoltre probabilmente
|
||||||
discoverable by end-users, unlike the typical uppercase files
|
poco rilevante per gli utenti finali, a differenza dei tipici file maiuscoli
|
||||||
(<code>README</code>, <code>CONTRIBUTING</code>, etc.). Another
|
(<code>README</code>, <code>CONTRIBUTING</code>, etc.). Un altro problema
|
||||||
minor issue is that the interface doesn't currently offer links to
|
minore è che l'interfaccia non offre attualmente link per la
|
||||||
commit logs between each release.
|
creazione di log tra ciascuna release.
|
||||||
%h4#automatic
|
%h4#automatic
|
||||||
%a.anchor{ href: "#automatic", aria_hidden: "true" }
|
%a.anchor{ href: "#automatic", aria_hidden: "true" }
|
||||||
Can changelogs be automatically parsed?
|
I changelog possono essere analizzati automaticamente?
|
||||||
|
|
||||||
%p
|
%p
|
||||||
It’s difficult, because people follow wildly different formats and
|
È difficile, perché le persone usano formati e nomi di file profondamente diversi.
|
||||||
file names.
|
|
||||||
|
|
||||||
%p
|
%p
|
||||||
#{link_to "Vandamme", vandamme} is a Ruby gem created by the
|
#{link_to "Vandamme", vandamme} è una Ruby gem
|
||||||
#{link_to "Gemnasium", gemnasium} team and which parses many (but
|
creata dal team #{link_to "Gemnasium", gemnasium} ed è in grado di fare il parsing dei
|
||||||
not all) open source project changelogs.
|
change log di molti (ma non tutti) i progetti open source.
|
||||||
|
|
||||||
|
|
||||||
%h4#yanked
|
%h4#yanked
|
||||||
%a.anchor{ href: "#yanked", aria_hidden: "true" }
|
%a.anchor{ href: "#yanked", aria_hidden: "true" }
|
||||||
What about yanked releases?
|
Cosa sono le release "yanked"?
|
||||||
|
|
||||||
%p
|
%p
|
||||||
Yanked releases are versions that had to be pulled because of a
|
Le release "yanked" sono versioni che sono state rimosse a causa di bug seri
|
||||||
serious bug or security issue. Often these versions don't even
|
o problemi di sicurezza. Spesso queste versioni non appaiono nei change
|
||||||
appear in change logs. They should. This is how you should display
|
log. Invece dovrebbero esserci, nel seguente modo:
|
||||||
them:
|
|
||||||
|
|
||||||
%p <code>## 0.0.5 - 2014-12-13 [YANKED]</code>
|
%p <code>## 0.0.5 - 2014-12-13 [YANKED]</code>
|
||||||
|
|
||||||
%p
|
%p
|
||||||
The <code>[YANKED]</code> tag is loud for a reason. It's important
|
L'etichetta <code>[YANKED]</code> è in maiuscolo per un motivo.
|
||||||
for people to notice it. Since it's surrounded by brackets it's also
|
È importante che le persone la notino.
|
||||||
easier to parse programmatically.
|
Poiché è racchiusa tra parentesi quadre è anche
|
||||||
|
più semplice da riconoscere nel parsing automatizzato.
|
||||||
|
|
||||||
|
|
||||||
%h4#rewrite
|
%h4#rewrite
|
||||||
%a.anchor{ href: "#rewrite", aria_hidden: "true" }
|
%a.anchor{ href: "#rewrite", aria_hidden: "true" }
|
||||||
Should you ever rewrite a changelog?
|
Si dovrebbe mai modificare un changelog?
|
||||||
|
|
||||||
%p
|
%p
|
||||||
Sure. There are always good reasons to improve a changelog. I
|
Certo. Ci sono sempre buoni motivi per migliorare un changelog. Io apro regolarmente
|
||||||
regularly open pull requests to add missing releases to open source
|
delle pull request per aggiungere release mancanti ai progetti open source che non mantengono
|
||||||
projects with unmaintained changelogs.
|
correttamente i changelog.
|
||||||
|
|
||||||
%p
|
%p
|
||||||
It's also possible you may discover that you forgot to address a
|
È anche possibile che si scopra di aver dimenticato di annotare una modifica
|
||||||
breaking change in the notes for a version. It's obviously important
|
non retro-compatibile nelle note per una versione. Ovviamente è importante aggiornare
|
||||||
for you to update your changelog in this case.
|
il changelog in questo caso.
|
||||||
|
|
||||||
|
|
||||||
%h4#contribute
|
%h4#contribute
|
||||||
%a.anchor{ href: "#contribute", aria_hidden: "true" }
|
%a.anchor{ href: "#contribute", aria_hidden: "true" }
|
||||||
How can I contribute?
|
Come posso contribuire?
|
||||||
|
|
||||||
%p
|
%p
|
||||||
This document is not the <strong>truth</strong>; it’s my carefully
|
Questo documento non è la <strong>verità assoluta</strong>; è solo la mia attenta
|
||||||
considered opinion, along with information and examples I gathered.
|
opinione, arricchita dalle informazioni ed esempi che ho raccolto.
|
||||||
|
|
||||||
%p
|
%p
|
||||||
This is because I want our community to reach a consensus. I believe
|
Questo è perché voglio che la nostra comunità raggiunga un consenso. Credo che
|
||||||
the discussion is as important as the end result.
|
la discussione sia importante almeno quanto il risultato finale.
|
||||||
|
|
||||||
%p
|
%p
|
||||||
So please <strong>#{link_to "pitch in", gh}</strong>.
|
Quindi per favore <strong>#{link_to "partecipate e dateci dentro", gh}</strong>.
|
||||||
|
|
||||||
.press
|
.press
|
||||||
%h3 Conversations
|
%h3 Conversations
|
||||||
%p
|
%p
|
||||||
I went on #{link_to "The Changelog podcast", thechangelog}
|
Sono andato su #{link_to "The Changelog podcast", thechangelog}
|
||||||
to talk about why maintainers and contributors should care about changelogs,
|
per parlare del perché i gestori e i contributori dovrebbero preoccuparsi dei changelog
|
||||||
and also about the motivations behind this project.
|
e anche delle motivazioni dietro questo progetto.
|
||||||
Contact GitHub API Training Shop Blog About
|
|
||||||
© 2017 GitHub, Inc. Terms Privacy Security Status Help
|
|
||||||
|
Loading…
x
Reference in New Issue
Block a user