translated rest of FAQ's and conservations

This commit is contained in:
Jasper Krielaars 2017-10-26 15:29:01 +02:00
parent b5a19ae227
commit 338926b54c

View File

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