diff --git a/source/nl/1.0.0/index.html.haml b/source/nl/1.0.0/index.html.haml index 614ea22..6cd83b0 100644 --- a/source/nl/1.0.0/index.html.haml +++ b/source/nl/1.0.0/index.html.haml @@ -149,85 +149,76 @@ version: 1.0.0 Deprecations negeren %p - When people upgrade from one version to another, it should be - painfully clear when something will break. It should be possible to - upgrade to a version that lists deprecations, remove what's - deprecated, then upgrade to the version where the deprecations - become removals. + Wanneer mensen upgraden van de ene naar de andere versie, + moet het overduidelijk zijn als er iets niet meer zal werken. + Het moet mogelijk zijn om te upgraden naar een versie met deprications, + afhanlekijkheden van de deprications weg te halen, en vervolgens + de upgrade kunnen doen naar de versie waar de deprications removals zijn geworden. %p - If you do nothing else, list deprecations, removals, and any - breaking changes in your changelog. - + Geef altijd op zijn minst de deprications, removals en changes met grote impact aan in je changelog. %h4#confusing-dates %a.anchor{ href: "#confusing-dates", aria_hidden: "true" } - Confusing Dates + Verwarrende datums %p - Regional date formats vary throughout the world and it's often - difficult to find a human-friendly date format that feels intuitive - to everyone. The advantage of dates formatted like - 2017-07-17 is that they follow the order of largest to - smallest units: year, month, and day. This format also doesn't - overlap in ambiguous ways with other date formats, unlike some - regional formats that switch the position of month and day numbers. - These reasons, and the fact this date format is an - #{link_to "ISO standard", iso} are why it is the recommended date - format for changelog entries. + Datum notaties verschillen van land tot land, en het is vaak moeilijk om + een notatie te vinden die makkelijk te lezen is en intuitief is voor iedereen. + + Het voordeel van de notatie 2017-07-17 is dat het jaar, maand en dag + op volgorde van grootte laat zien. Daarom, en het feit dat dit een #{link_to "ISO standaard", iso} + is, is dit de aanbevolen datum notatie voor changelog releases. %aside - There’s more. Help me collect these antipatterns by - = link_to "opening an issue", issues - or a pull request. + Dit is niet alles. Help mij antipatterns te verzamelen door + = link_to "een issue", issues + of een pull request aan te maken. .frequently-asked-questions %h3#frequently-asked-questions %a.anchor{ href: "#frequently-asked-questions", aria_hidden: "true" } - Frequently Asked Questions + Veel Gestelde Vragen %h4#standard %a.anchor{ href: "#standard", aria_hidden: "true" } - Is there a standard changelog format? + Is er een standaard changelog template? %p - Not really. There's the GNU changelog style guide, or the two- - paragraph-long GNU NEWS file "guideline". Both are inadequate or - insufficient. + Niet echt. Er is de GNU changelog style guide, en de twee paragrafen GNU NEWS bestand "richtlijnen". + Beiden zijn niet volledig genoeg. %p - This project aims to be - = link_to "a better changelog convention.", changelog - It comes from observing good practices in the open source - community and gathering them. + Dit project poogt + = link_to "een betere changelog standaard", changelog + te creëren. Dit op basis van bewezen "good practices" uit de open source wereld. %p - Healthy criticism, discussion and suggestions for improvements - = link_to "are welcome.", issues + Opbouwende kritiek, discussie en suggesties voor verbetering + = link_to "zijn welkom.", issues %h4#filename %a.anchor{ href: "#filename", aria_hidden: "true" } - What should the changelog file be named? + Wat zou de changelog bestandsnaam moeten zijn? %p - Call it CHANGELOG.md. Some projects use - HISTORY, NEWS or RELEASES. + Noem het CHANGELOG.md. Sommige projecten gebruiken + HISTORY, NEWS of RELEASES. %p - While it's easy to think that the name of your changelog file - doesn't matter that much, why make it harder for your end users to - consistently find notable changes? + Je kan denken dat de bestandsnaam niet heel belanrijk is, + maar waarom zou je het de eindgebruikers moeilijker maken om de changelog te vinden? %h4#github-releases %a.anchor{ href: "#github-releases", aria_hidden: "true" } - What about GitHub Releases? + Wat denk je van GitHub Releases? %p - It's a great initiative. #{link_to "Releases", ghr} can be used to - turn simple git tags (for example a tag named v1.0.0) - into rich release notes by manually adding release notes or it can - pull annotated git tag messages and turn them into notes. + Het is een goed initiatief. #{link_to "Releases", ghr} kan gebruikt worden + om simpele git tags (bijvoorbeeld een tag met naam v1.0.0) + te veranderen in uitgebreide release notes door deze handmatig toe te voegen of + door geannoteerde git tag berichten te gebruiken om release notes te genereren. %p GitHub Releases create a non-portable changelog that can only be