mirror of
https://github.com/olivierlacan/keep-a-changelog.git
synced 2025-07-30 17:24:25 +02:00
translated rest of FAQ's and conservations
This commit is contained in:
parent
b5a19ae227
commit
338926b54c
@ -221,83 +221,79 @@ version: 1.0.0
|
|||||||
door geannoteerde git tag berichten te gebruiken om release notes te genereren.
|
door geannoteerde git tag berichten te gebruiken om release notes te genereren.
|
||||||
|
|
||||||
%p
|
%p
|
||||||
GitHub Releases create a non-portable changelog that can only be
|
GitHub Releases maken changelog wat alleen getoond kan worden aan gebruikers
|
||||||
displayed to users within the context of GitHub. It's possible to
|
binnen de context van GitHub. Het is mogelijk om deze dicht bij het format
|
||||||
make them look very much like the Keep a Changelog format, but it
|
te krijgen wat wij hier promoten, maar er zal iets meer werk voor nodig zijn.
|
||||||
tends to be a bit more involved.
|
|
||||||
|
|
||||||
%p
|
%p
|
||||||
The current version of GitHub releases is also arguably not very
|
De huidige versie van GitHub releases is naar mijn mening niet
|
||||||
discoverable by end-users, unlike the typical uppercase files
|
echt goed vindbaar voor gebruikers, in tegenstelling tot de typische
|
||||||
(<code>README</code>, <code>CONTRIBUTING</code>, etc.). Another
|
bestanden die in een naam in hoofdletters hebben
|
||||||
minor issue is that the interface doesn't currently offer links to
|
(<code>README</code>, <code>CONTRIBUTING</code>, etc.).
|
||||||
commit logs between each release.
|
Een ander knelpunt is dat de interface geen links toestaat naar
|
||||||
|
commit logs van elke release.
|
||||||
|
|
||||||
%h4#automatic
|
%h4#automatic
|
||||||
%a.anchor{ href: "#automatic", aria_hidden: "true" }
|
%a.anchor{ href: "#automatic", aria_hidden: "true" }
|
||||||
Can changelogs be automatically parsed?
|
Kunnen changelogs automatisch geparsed worden?
|
||||||
|
|
||||||
%p
|
%p
|
||||||
It’s difficult, because people follow wildly different formats and
|
Dat is lasig, mensen gebruiken immers veel verschillende formats en bestandsnamen.
|
||||||
file names.
|
|
||||||
|
|
||||||
%p
|
%p
|
||||||
#{link_to "Vandamme", vandamme} is a Ruby gem created by the
|
#{link_to "Vandamme", vandamme} is een Ruby gem van het
|
||||||
#{link_to "Gemnasium", gemnasium} team and which parses many (but
|
#{link_to "Gemnasium", gemnasium} team wat de changelogs van veel (maar niet alle)
|
||||||
not all) open source project changelogs.
|
open source projecten kan parsen.
|
||||||
|
|
||||||
|
|
||||||
%h4#yanked
|
%h4#yanked
|
||||||
%a.anchor{ href: "#yanked", aria_hidden: "true" }
|
%a.anchor{ href: "#yanked", aria_hidden: "true" }
|
||||||
What about yanked releases?
|
Wat doen we met teruggetrokken (yanked) releases?
|
||||||
|
|
||||||
%p
|
%p
|
||||||
Yanked releases are versions that had to be pulled because of a
|
Teruggetrokken releases zijn versies die teruggetrokken zijn als gevolg
|
||||||
serious bug or security issue. Often these versions don't even
|
van een serieuze bug of beveiligings probleem. Vaak zijn ze niet eens te zien in
|
||||||
appear in change logs. They should. This is how you should display
|
de changelogs. Dat zou wel moeten. Zo zou je een teruggetrokken release moeten tonen:
|
||||||
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
|
De <code>[YANKED]</code> tag is in hoofdletters voor een reden. Het is belanrijk
|
||||||
for people to notice it. Since it's surrounded by brackets it's also
|
dat mensen dit zien. Omdat het tussen blokhaken genoteerd is, is het ook makkelijker
|
||||||
easier to parse programmatically.
|
automatisch te parsen.
|
||||||
|
|
||||||
|
|
||||||
%h4#rewrite
|
%h4#rewrite
|
||||||
%a.anchor{ href: "#rewrite", aria_hidden: "true" }
|
%a.anchor{ href: "#rewrite", aria_hidden: "true" }
|
||||||
Should you ever rewrite a changelog?
|
Mag je een changelog aanpassen/herschrijven?
|
||||||
|
|
||||||
%p
|
%p
|
||||||
Sure. There are always good reasons to improve a changelog. I
|
Natuurlijk. Er zijn goede redenen om een changelog te verbeteren.
|
||||||
regularly open pull requests to add missing releases to open source
|
Ik open regelmatig een pull request om missende releases toe te
|
||||||
projects with unmaintained changelogs.
|
voegen aan open source projecten met een slecht onderhouden changelog.
|
||||||
|
|
||||||
%p
|
%p
|
||||||
It's also possible you may discover that you forgot to address a
|
Het kan ook zo zijn dat je ontdekt dat je een belanrijke aanpassing niet
|
||||||
breaking change in the notes for a version. It's obviously important
|
vermeld hebt in je changelog. Het is dan natuurlijk zaak om dit alsnog
|
||||||
for you to update your changelog in this case.
|
in je changelog te vermelden.
|
||||||
|
|
||||||
|
|
||||||
%h4#contribute
|
%h4#contribute
|
||||||
%a.anchor{ href: "#contribute", aria_hidden: "true" }
|
%a.anchor{ href: "#contribute", aria_hidden: "true" }
|
||||||
How can I contribute?
|
Hoe kan ik bijdragen?
|
||||||
|
|
||||||
%p
|
%p
|
||||||
This document is not the <strong>truth</strong>; it’s my carefully
|
Dit document is niet de <strong>waarheid</strong; het is mijn
|
||||||
considered opinion, along with information and examples I gathered.
|
weloverwogen mening, samen met wat informatie en voorbeelden die ik verzameld heb.
|
||||||
|
|
||||||
%p
|
%p
|
||||||
This is because I want our community to reach a consensus. I believe
|
Dit heb ik gedaan omdat ik wil dat de programmeer gemeenschap een consensus bereikt.
|
||||||
the discussion is as important as the end result.
|
Ik denk dat de discussie net zo belanrijk is als het eindresultaat.
|
||||||
|
|
||||||
%p
|
%p
|
||||||
So please <strong>#{link_to "pitch in", gh}</strong>.
|
Dus <strong>#{link_to "alle hulp is welkom", gh}</strong>.
|
||||||
|
|
||||||
.press
|
.press
|
||||||
%h3 Conversations
|
%h3 Conversaties
|
||||||
%p
|
%p
|
||||||
I went on #{link_to "The Changelog podcast", thechangelog}
|
Ik was te gast bij #{link_to "The Changelog podcast", thechangelog} om te praten over
|
||||||
to talk about why maintainers and contributors should care about changelogs,
|
waarom een changelog belanrijk zou moeten zijn voor programmeurs, en over mijn motivatie achter dit project.
|
||||||
and also about the motivations behind this project.
|
|
||||||
|
Loading…
x
Reference in New Issue
Block a user