Completed a superficial translation

This commit is contained in:
Michele Castoldi 2017-06-28 10:46:22 +02:00 committed by GitHub
parent 9d28f732c8
commit aae188a899

View File

@ -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
Its 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>; its 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