From 338926b54ca56f963ef6428ade54fb50949162bc Mon Sep 17 00:00:00 2001 From: Jasper Krielaars Date: Thu, 26 Oct 2017 15:29:01 +0200 Subject: [PATCH] translated rest of FAQ's and conservations --- source/nl/1.0.0/index.html.haml | 78 ++++++++++++++++----------------- 1 file changed, 37 insertions(+), 41 deletions(-) diff --git a/source/nl/1.0.0/index.html.haml b/source/nl/1.0.0/index.html.haml index 6cd83b0..65c8da1 100644 --- a/source/nl/1.0.0/index.html.haml +++ b/source/nl/1.0.0/index.html.haml @@ -221,83 +221,79 @@ version: 1.0.0 door geannoteerde git tag berichten te gebruiken om release notes te genereren. %p - GitHub Releases create a non-portable changelog that can only be - displayed to users within the context of GitHub. It's possible to - make them look very much like the Keep a Changelog format, but it - tends to be a bit more involved. + GitHub Releases maken changelog wat alleen getoond kan worden aan gebruikers + binnen de context van GitHub. Het is mogelijk om deze dicht bij het format + te krijgen wat wij hier promoten, maar er zal iets meer werk voor nodig zijn. %p - The current version of GitHub releases is also arguably not very - discoverable by end-users, unlike the typical uppercase files - (README, CONTRIBUTING, etc.). Another - minor issue is that the interface doesn't currently offer links to - commit logs between each release. + De huidige versie van GitHub releases is naar mijn mening niet + echt goed vindbaar voor gebruikers, in tegenstelling tot de typische + bestanden die in een naam in hoofdletters hebben + (README, CONTRIBUTING, etc.). + Een ander knelpunt is dat de interface geen links toestaat naar + commit logs van elke release. %h4#automatic %a.anchor{ href: "#automatic", aria_hidden: "true" } - Can changelogs be automatically parsed? + Kunnen changelogs automatisch geparsed worden? %p - It’s difficult, because people follow wildly different formats and - file names. + Dat is lasig, mensen gebruiken immers veel verschillende formats en bestandsnamen. %p - #{link_to "Vandamme", vandamme} is a Ruby gem created by the - #{link_to "Gemnasium", gemnasium} team and which parses many (but - not all) open source project changelogs. + #{link_to "Vandamme", vandamme} is een Ruby gem van het + #{link_to "Gemnasium", gemnasium} team wat de changelogs van veel (maar niet alle) + open source projecten kan parsen. %h4#yanked %a.anchor{ href: "#yanked", aria_hidden: "true" } - What about yanked releases? + Wat doen we met teruggetrokken (yanked) releases? %p - Yanked releases are versions that had to be pulled because of a - serious bug or security issue. Often these versions don't even - appear in change logs. They should. This is how you should display - them: + Teruggetrokken releases zijn versies die teruggetrokken zijn als gevolg + van een serieuze bug of beveiligings probleem. Vaak zijn ze niet eens te zien in + de changelogs. Dat zou wel moeten. Zo zou je een teruggetrokken release moeten tonen: %p ## 0.0.5 - 2014-12-13 [YANKED] %p - The [YANKED] tag is loud for a reason. It's important - for people to notice it. Since it's surrounded by brackets it's also - easier to parse programmatically. + De [YANKED] tag is in hoofdletters voor een reden. Het is belanrijk + dat mensen dit zien. Omdat het tussen blokhaken genoteerd is, is het ook makkelijker + automatisch te parsen. %h4#rewrite %a.anchor{ href: "#rewrite", aria_hidden: "true" } - Should you ever rewrite a changelog? + Mag je een changelog aanpassen/herschrijven? %p - Sure. There are always good reasons to improve a changelog. I - regularly open pull requests to add missing releases to open source - projects with unmaintained changelogs. + Natuurlijk. Er zijn goede redenen om een changelog te verbeteren. + Ik open regelmatig een pull request om missende releases toe te + voegen aan open source projecten met een slecht onderhouden changelog. %p - It's also possible you may discover that you forgot to address a - breaking change in the notes for a version. It's obviously important - for you to update your changelog in this case. - + Het kan ook zo zijn dat je ontdekt dat je een belanrijke aanpassing niet + vermeld hebt in je changelog. Het is dan natuurlijk zaak om dit alsnog + in je changelog te vermelden. %h4#contribute %a.anchor{ href: "#contribute", aria_hidden: "true" } - How can I contribute? + Hoe kan ik bijdragen? %p - This document is not the truth; it’s my carefully - considered opinion, along with information and examples I gathered. + Dit document is niet de waarheid#{link_to "pitch in", gh}. + Dus #{link_to "alle hulp is welkom", gh}. .press - %h3 Conversations + %h3 Conversaties %p - I went on #{link_to "The Changelog podcast", thechangelog} - to talk about why maintainers and contributors should care about changelogs, - and also about the motivations behind this project. + Ik was te gast bij #{link_to "The Changelog podcast", thechangelog} om te praten over + waarom een changelog belanrijk zou moeten zijn voor programmeurs, en over mijn motivatie achter dit project.