open-zaak · clausmullie · Apr 16, 2020 · Apr 15, 2020 · Apr 15, 2020 · Apr 15, 2020
diff --git a/CODE_OF_CONDUCT.md b/CODE_OF_CONDUCT.md
@@ -22,7 +22,7 @@ Technical steering team members have the right and responsibility to remove, edi
 
 ## Scope
 
-This Code of Conduct applies within all project spaces, and it also applies when an individual is representing the project or its community in public spaces. Examples of representing a project or community include using an officialproject e-mail address, posting via an official social media account, or acting as an appointed representative at an online or offline event. Representation of a project may be further defined and clarified by project maintainers.
+This Code of Conduct applies within all project spaces, and it also applies when an individual is representing the project or its community in public spaces. Examples of representing a project or community include using an official project e-mail address, posting via an official social media account, or acting as an appointed representative at an online or offline event. Representation of a project may be further defined and clarified by project maintainers.
 
 ## Enforcement
 

diff --git a/GOVERNANCE.md b/GOVERNANCE.md
@@ -14,7 +14,7 @@ The OpenZaak community adheres to the following principles:
 * OpenZaak is open source.
 * We're a welcoming and respectful community as mentioned in our [Code of Conduct](GOVERNANCE.md#Code-of-Conduct).
 * Transparent and accessible, changes to the OpenZaak organization, OpenZaak code repositories, and OpenZaak related activities (e.g. level, involvement, etc) are done in public.
-* Ideas and contributions are accepted according to their technical merit and alignment with project objectives, scope, and design principles.
+* Ideas and contributions are accepted according to their technical and functional merit and alignment with project objectives, scope, and design principles.
 
 The maintainers of OpenZaak have two steering teams, a technical one and a product one.
 
@@ -39,12 +39,12 @@ The current team members are:
 The technical steering team has the joint responsibility to:
 
 * Provide technical direction for the codebase
-* Maintain a technical roadmap, an architecure and coding principles
+* Maintain a technical roadmap, architecture and coding principles
 * Resolve issues in development or conflicts between contributors
 * Managing and planning releases
 * Controlling rights to Open Zaak assets such as source repositories
 
-The technical steering team meets regularly. Their agenda includes reivew of the technical roadmap and issues that are at an impasse. The intention of the agenda is not to review or approve all patches. This is mainly being done through the process described in the contributing guide.
+The technical steering team meets regularly. Their agenda includes review of the technical roadmap and issues that are at an impasse. The intention of the agenda is not to review or approve all patches. This is mainly being done through the process described in the contributing guide.
 
 If more than one technical steering team member disagrees with a decision of the technical steering team they may appeal to the product steering team who will make the ultimate ruling.
 
@@ -65,7 +65,7 @@ Responsibilities of the product steering team:
 
 Members are appointed by the current product steering team members.
 
-Changes in codebase governance can only be done by the product steering team and requires super majority. 
+Changes in codebase governance can only be done by the product steering team and requires supermajority (2/3).
 
 The current team members are:
 
@@ -80,9 +80,9 @@ When a consensus cannot be found a team member can call for a majority vote on a
 Many of the day-to-day project maintenance tasks can be done by a lazy consensus model. But the following items must be called to vote:
 
 * Adding a team member (simple majority)
-* Removing a team member (super majority)
-* Changing the governance rules (this document) (super majority) 
-* Licensing and intellectual property changes (including new logos, wordmarks) (simple majority)
+* Removing a team member (supermajority)
+* Changing the governance rules (this document) (supermajority)
+* Licensing and intellectual property changes (including new logos, wordmarks) (supermajority)
 * Adding, archiving, or removing subprojects (simple majority)
 
 ## Code of Conduct

diff --git a/how-to-respond-en.md b/how-to-respond-en.md
@@ -17,7 +17,7 @@ We want to use your experience, inspiration and brainpower to come to the right
 
 The market consultation consists of two parts:
 
-1. A written response to our questions. We're deliberately not restricting the form and length of your answers. These responses should be received by 1-5-2020 before 17:00. You can send your answers to [email protected]. Based on your responses we will review our proposal and adjust it if there are good suggestions. This modified proposal will then become the starting point for the workshop (part two of the consultation).
+1. A written response to our questions. We're deliberately not restricting the form and length of your answers. These responses should be received by 1-5-2020 before 17:00. You can send your answers to <[email protected]>. Based on your responses we will review our proposal and adjust it if there are good suggestions. This modified proposal will then become the starting point for the workshop (part two of the consultation).
 2. Optional: one or more workshops where together we will determine the various needs and prerequisites within the community (participation only on request of OpenZaak). After submitting your answers, you will receive a message no later than 13-5-2020 if you are invited for the workshop. This will take place on 20th and 21st of May 2020. With the invitation you will receive further information about the exact time and location.
 
 Dimpact is responsible for the communication about this market consultation. You can contact Niels Lindeboom at <[email protected]> or 06-22270923.

diff --git a/how-to-respond-nl.md b/how-to-respond-nl.md
@@ -7,7 +7,7 @@ Op deze pagina wordt het proces en het tijdschema voor de reactie op de marktcon
 
 ## Uitgangspunten marktconsultatie
 
-Met OpenZaak realiseren we een belangrijke stap om de [Common Ground](https://commonground.nl/cms/view/54476259/over-common-ground) principes te realiseren. Maar wij realiseren ons goed dat het pas van waarde is als het actief wordt gebruikt en doorontwikkelt.
+Met OpenZaak realiseren we een belangrijke stap om de [Common Ground](https://commonground.nl/cms/view/54476259/over-common-ground) principes te realiseren. Maar wij realiseren ons goed dat het pas van waarde is als het actief wordt gebruikt en doorontwikkeld.
 
 Onze motivatie is een community te realiseren waarin overheid, leveranciers en partners samenwerken. Een community, zonder lock-ins, die voor alle betrokken werkt. Vanuit die gezamenlijkheid willen we ook deze marktconsultatie opzetten.
 
@@ -17,7 +17,7 @@ We willen jullie ervaring, inspiratie en denkkracht inzetten om tot de juiste op
 
 De marktconsultatie bestaat uit twee onderdelen.
 
-1. Een schriftelijke reactie op onze vragen. We stellen bewust geen restricties aan de vorm en lengte van jullie antwoorden. Deze reacties dienen uiterlijk op 1-5-2020 vóór 17:00 uur ontvangen te zijn. U kunt uw antwoorden sturen aan [email protected]. Op basis van jullie antwoorden gaan wij opnieuw kijken naar ons voorstel en dit aanpassen als er goede suggesties zijn gegeven. Dit aangepaste voorstel wordt dan het uitgangspunt voor de workshop (deel twee van de consultatie).
+1. Een schriftelijke reactie op onze vragen. We stellen bewust geen restricties aan de vorm en lengte van jullie antwoorden. Deze reacties dienen uiterlijk op 1-5-2020 vóór 17:00 uur ontvangen te zijn. Jij kunt je antwoorden sturen aan <[email protected]>. Op basis van jullie antwoorden gaan wij opnieuw kijken naar ons voorstel en dit aanpassen als er goede suggesties zijn gegeven. Dit aangepaste voorstel wordt dan het uitgangspunt voor de workshop (deel twee van de consultatie).
 2. Optioneel: een of meer workshops waarin we met elkaar de diverse behoefte en voorwaarden binnen de community gaan bepalen (deelname alleen op verzoek van OpenZaak). Na het indienen van jullie antwoorden ontvang je uiterlijk 13-5-2020 2020 een bericht of je wordt uitgenodigd voor de workshop. Deze vinden plaats op 20/21-5-2020. Bij de uitnodiging ontvang je verdere informatie over de exacte tijd en locatie.
 
 De communicatie over deze marktconsultatie verloopt via Dimpact. Je kunt contact opnemen met Niels Lindeboom op <[email protected]> of 06-22270923.
@@ -37,7 +37,7 @@ Nadat de geïnteresseerde partijen de vragen uit het marktconsultatiedocument he
 
 ## Juridische aspecten
 
-Dit document is alleen bestemd voor marktconsultatie doeleinden. Het wordt ter beschikking gesteld onder de uitdrukkelijke voorwaarde dat het uitsluitend gebruikt wordt om suggesties en ideeën aan te reiken. Een deelname aan deze marktconsultatie kan niet leiden tot verplichtingen van de deelnemende marktpartijen om overeenkomsten met de deelnemende gemeenten of Dimpact aan te gaan, en vice versa. Aan de deelname van de marktconsultatie is geen vergoeding van kosten verbonden.
+Dit document is alleen bestemd voor marktconsultatie doeleinden. Het wordt ter beschikking gesteld onder de uitdrukkelijke voorwaarde dat het uitsluitend gebruikt wordt om suggesties en ideeën aan te reiken. Een deelname aan deze marktconsultatie kan niet leiden tot verplichtingen van de deelnemende marktpartijen om overeenkomsten met de deelnemende gemeenten of Dimpact aan te gaan, en vice versa. Aan deelname van de marktconsultatie is geen vergoeding van kosten verbonden.
 
 | <a href="README.md">Home</a> | <a href="introduction-nl.md">Inleiding</a> | <a href="questions-nl.md">Onze voorstellen en vragen</a> | Reageren op de marktconsultatie  |
 | -------- | -------- | -------- | -------- |
diff --git a/introduction-nl.md b/introduction-nl.md
@@ -17,13 +17,13 @@ De OpenZaak codebase helpt Nederlandse gemeenten om te voldoen aan de [VNG-stand
 
 De deelnemende gemeenten zijn op zoek naar geïnteresseerde leveranciers om hen te ondersteunen bij de implementatie van de codebase (onder meer in de ontwikkeling, onderhoud, implementatie en ondersteuning). De ambitie is om een gezonde open source community te hebben waarin leveranciers de mogelijkheid krijgen om de markt voor OpenZaak te laten groeien, en waarin inkoop wordt vereenvoudigd en gestandaardiseerd.
 
-Hiervoor vinden we het belangrijk om een open en collaboratieve gemeenschap te hebben, inclusief één codebase met een gemeenschappelijke governancestructuur en een gedeeld begrip over bugfixes en -ondersteuning. Meer informatie over de behoeften, conceptvisie en open vragen van de gemeenten is te vinden in [onze voorstellen en vragen](questions-nl.md) en het [draft governance.md document](governance.md).
+Hiervoor vinden we het belangrijk om een open en samenwerkende gemeenschap te hebben, inclusief één codebase met een gemeenschappelijke governancestructuur en een gedeeld begrip over bugfixes en ondersteuning. Meer informatie over de behoeften, conceptvisie en open vragen van de gemeenten is te vinden in [onze voorstellen en vragen](questions-nl.md) en het [draft governance.md document](governance.md).
 
 ## Over deze marktconsultatie
 
-Marktpartijen die geïnteresseerd zijn in deelname worden gevraagd [onze voorstellen en vragen](questions-nl.md) zorgvuldig te herzien en te reageren op de daar genoemde vragen.
+Marktpartijen die geïnteresseerd zijn in deelname worden gevraagd [onze voorstellen en vragen](questions-nl.md) zorgvuldig te lezen en te reageren op de daar genoemde vragen.
 
-De antwoorden moeten voor 1-5-2020 worden ontvangen door Niels Lindeboom. Op basis van deze antwoorden kunnen marktpartijen samen met de gemeenten worden uitgenodigd voor één of meerdere workshops om te bepalen hoe de OpenZaak-gemeenschap kan worden opgezet. Meer informatie over dit marktraadplegingsproces is te vinden in [hoe te reageren](how-to-respond-nl.md).
+De antwoorden moeten voor 1-5-2020 binnen zijn bij Niels Lindeboom. Op basis van deze antwoorden kunnen marktpartijen samen met de gemeenten worden uitgenodigd voor één of meerdere workshops om te bepalen hoe de OpenZaak-gemeenschap kan worden opgezet. Meer informatie over dit marktraadplegingsproces is te vinden in [hoe te reageren](how-to-respond-nl.md).
 
 Deze marktconsultatie wordt georganiseerd door [Dimpact](https://www.dimpact.nl/), in opdracht van de OpenZaak gemeenten, ondersteund door de [Foundation for Public Code](https://publiccode.net/).
 

diff --git a/questions-en.md b/questions-en.md
@@ -20,7 +20,7 @@ For vendors it is important to grow the number of replicating municipalities (in
 Without knowing all the answers in detail, our vision for this community includes:
 
 * collaborating on a single, vendor-neutral codebase and shared branching model, avoiding diverging forks
-* collaborative governance, including around shared roadmaps (feature and technical) and open issue tracker
+* governance based on collaboration, including around shared roadmaps (feature and technical) and public issue tracker
 * a shared understanding of how to approach bug fixes and support, particularly in situations of operational downtime or security risks
 * an inclusive community (including open communication channels, codebase marketing material and codes of conduct) that is welcoming to new market parties and new replicating municipalities
 * empowering vendors to become effective members and ambassadors of the community
@@ -131,7 +131,7 @@ There will be a central, public and prioritised issue tracker for features and b
 
 #### Assumptions
 
-Many municipalities will prefer to have a single provider they can call for all their needs. This ranges from questions, bugs, ideas for new features, technical integration, training, configuration of permissions/authorisation, notifications, and so forth. Our assumption is that in many cases, no single vendor will want to or be able to provide all these services.
+Many municipalities will prefer to have a single provider they can call for all their needs. This ranges from questions, bugs, ideas for new features, technical integration and training to configuration of permissions/authorisation, notifications, and so forth. Our assumption is that in many cases, no single vendor will want to or be able to provide all these services.
 
 #### Questions
 

diff --git a/questions-nl.md b/questions-nl.md
@@ -20,8 +20,8 @@ Voor leveranciers is het belangrijk om het aantal deelnemende gemeenten te laten
 Zonder alle antwoorden in detail te kennen, omvat onze visie voor de community:
 
 * samenwerken aan één leverancier-neutrale codebase en shared branchingmodel, waarbij uiteenlopende forks worden vermeden
-* collaborative governance, inclusief rond gedeelde roadmaps (feature en technical) en open issue tracker
-* een gedeeld inzicht in hoe bugfixes en -ondersteuning kunnen worden aangepakt, met name in situaties van operationele downtime of beveiligingsrisico's
+* governance op basis van samenwerking, waarbij ook wordt samengewerkt rond gedeelde roadmaps  (feature en technical) en openbare issue tracker
+* een gedeeld inzicht in hoe bugfixes en ondersteuning kunnen worden aangepakt, met name in situaties van operationele downtime of beveiligingsrisico's
 * een inclusieve community (inclusief open communicatiekanalen, codebase marketingmateriaal en codes of conduct) die nieuwe marktpartijen en nieuwe deelnemende gemeenten verwelkomt
 * leveranciers in staat stellen om effectieve leden en ambassadeurs van de community te worden
 
@@ -81,7 +81,7 @@ Zij moeten in de community samenwerken aan:
 
 Deze sectie bevat een lijst met open vragen. Elk deel bevat onze huidige veronderstellingen en een reeks open vragen die we willen bespreken met de leveranciersgemeenschap.
 
-Let op: vragen zijn indicatief, we horen graag uw mening over elk van de punten in deze bijlage.
+Let op: vragen zijn indicatief, we horen graag jouw mening over elk van de punten in deze bijlage.
 
 ### 1. Single shared codebase
 
@@ -111,7 +111,7 @@ Deze marktconsultatie omvat een [ontwerpvoorstel van een governancestructuur](go
 2. Wat zijn de uitdagingen die u voorziet bij het onderhouden van open backlogs bij uw klanten?
 3. Wie moet verantwoordelijk zijn voor het bijwerken van de shared roadmap? U, de gemeenten, of een gedeelde verantwoordelijkheid?
 4. Hoe wilt u de gedeelde feature en technical roadmap kunnen beïnvloeden?
-5. Hoe wilt u dat de community omgaat met het ontwikkelen, eens worden en onderhouden van gedeelde engineering en contributing guidelines?
+5. Hoe wilt u dat de community omgaat met het ontwikkelen, eens worden over en onderhouden van gedeelde engineering en contributing guidelines?
 6. Welke risico’s ziet u in het werken in zo'n omgeving?
 
 ### 3. Bugs en bug fixes
@@ -143,7 +143,7 @@ Veel gemeenten zullen de voorkeur geven aan één enkele leverancier die ze kunn
 
 #### Veronderstellingen
 
-De OpenZaak API's zijn gebaseerd op een VNG standaard, de [API's voor zaakgericht werken](https://www.vngrealisatie.nl/producten/api-standaarden-zaakgericht-werken). De standaard wordt continu onderhouden en verbeterd en OpenZaak moet daaraan blijven voldoen. Deze updates moeten worden gepropageerd over de centrale repository-branche, evenals repositories die marktpartijen gebruiken om hun diensten te leveren (zoals backend-as-a-service).
+De OpenZaak API's zijn gebaseerd op een VNG standaard, de [API's voor zaakgericht werken](https://www.vngrealisatie.nl/producten/api-standaarden-zaakgericht-werken). De standaard wordt continu onderhouden en verbeterd en OpenZaak moet daaraan blijven voldoen. Deze updates moeten worden gepropageerd naar de centrale repository-branche, evenals repositories die marktpartijen gebruiken om hun diensten te leveren (zoals backend-as-a-service).
 
 #### Vragen