all committed

docs/GOVERNANCE.md

@@ -4,19 +4,17 @@ Het succes en de continue verbetering van het OpenWoo.app project zijn afhankeli
 
 ## Open Webconcept
 
-OpenWoo.app is een doorontwikkeling van de OpenWoo wordpress plugin uit OpenWebconcept. Vanuit die oorsprong is OpenWoo.app eigenlijk een subcommunity van OpenWebconcept. De community staat echter nadrukkenlijk open voor niet OWC afnemers en leveranciers.
+OpenWoo.app is een doorontwikkeling van de OpenWoo WordPress-plugin uit Open Webconcept. Vanuit die oorsprong is OpenWoo.app eigenlijk een subcommunity van OpenWebconcept. De community staat echter nadrukkelijk open voor niet OWC-afnemers en leveranciers.
 
 De gemeente Gouda vormt hierin de linking pin
 
-
-Gemeenten zo als Noordwijk, Gouda, Barendrecht, Allbaserwaard, Ridderkerk en Hoeksewaard vormen met de deelname aan 
-
+Gemeenten zo als Noordwijk, Gouda, Barendrecht, Alblasserwaard, Ridderkerk en Hoeksche Waard vormen met de deelname aan
 
 ## Community Meetings
 
-Iedereen die actief gebruik maakt OpenWoo.app of intresse heeft in de ontwikkeling hiervan is welkom op de maandenlijke community meeting. De community meetings zijn de plek waar we de roadmap doornemen daar proberen gemeenchapenlijk beslutien op te nemen
+Iedereen die actief gebruik maakt OpenWoo.app of interesse heeft in de ontwikkeling hiervan is welkom op de maandelijkse community meeting. De community meetings zijn de plek waar we de roadmap doornemen daar proberen gemeenschappelijk besluiten op te nemen
 
-De community meetings worden aangekondigd via openwoo.app, linkedin en per mail aan de bekenende leveranciers en afnemeners.
+De community meetings worden aangekondigd via openwoo.app, LinkedIn en per mail aan de bekende leveranciers en afnemers.
 
 ## Stuurgroep
 

docs/KoopHulp.md

@@ -2,10 +2,6 @@
 
 Vanuit de gemeente Buren is Koophulpje.nl opgezet. Het doel van Koophulpje is het doen van een proof of concept (poc) met de OpenWoo.app en het stellen van integrale zoek vragen aan de hand van het federale data stelsel (FSC) en API's.
 
-## Voorgeschiedenis
-
-asd
-
 ## Voordelen
 
 - Het uitvragen van informatie via API's is gemakkelijker te integreren dan sitemap.xml

docs/partners/Datamask.md

@@ -1,37 +1,44 @@
 # Datamask
-OpenWoo.app en Datamask willen graag een gemeenschappenlijek propositie voeren voor de WOO
+
+OpenWoo.app en Datamask willen graag een gemeenschappelijke propositie voeren voor de WOO
 
 ## Product Datamask
-Datamask zet de kracht van haar reeds bestaande koppelingen vanuit haar anonimiserings tool (en e.v.t. publicatie platform) in 
+
+Datamask zet de kracht van haar reeds bestaande koppelingen vanuit haar anonimiseringstool (en e.v.t. publicatie platform) in
 
 Heeft wel
-- Anonimesering
+
+- Anonimisering
 - Zoekindex a.h.v huidige koppelingen
 - Organisatie breder publicatie pagina
 - Beheerschermen en configuratie op de inrichting
 
 Heeft niet
+
 - Federatief en organisatie overkoepelend zoeken
 
 ## Product OpenWoo.app
+
 Datamask zet de kracht van haar data federalisatie en common ground netwerk in.
 
 Heeft wel
+
 - Federaliseren van indexen
 - NL Design voorkant
 - Volledig open source
 - Koppeling met Koop
-- Meezoeken in andere organisaties (samenwerkings verbanden, provincies etc)
-- Ondersteuning vanuit het common ground programma
+- Meezoeken in andere organisaties (samenwerkingsverbanden, provincies etc.)
+- Ondersteuning vanuit het Common Ground programma
 
-Heeft niet
-- Anonimeseringstool
-- Beheers interface op het koppelvlak
+Heeft geen
+
+- Anonimiseringstool
+- Beheerinterface op het koppelvlak
 
 ## Samenwerking
-De samenwerking kan er redelijk simpel uitzien, Datamask kan als aditionele funtionaliteit publiceren richting OpenWoo.app (daarvoor moet de betreffende afnemer wel over het motorblok van OpenWoo.app en Datamask beschicken). Vervolgens kan OpenWoo.app deze data beschickbaar maken op haar federale netwerk en door publiceren naar KOOP en WOOGLE aanvullend kan Datamask ook gegevens ophalen vanuit OpenWoo.app en zo ook aanvullende catageorien naast verzoeken weergeven in haar publicatie platform.
 
+De samenwerking kan er redelijk simpel uitzien, Datamask kan als additionele functionaliteit publiceren richting OpenWoo.app (daarvoor moet de betreffende afnemer wel over het motorblok van OpenWoo.app en Datamask beschikken). Vervolgens kan OpenWoo.app deze data beschikbaar maken op haar federale netwerk en door publiceren naar KOOP en WooGLe aanvullend kan Datamask ook gegevens ophalen vanuit OpenWoo.app en zo ook aanvullende categorieën naast verzoeken weergeven in haar publicatie platform.
 
 ## Architectuur
 
-![OpenWeb Architecture](https://raw.githubusercontent.com/ConductionNL/woo-website-template/main/docs/Datamask.svg)
+![OpenWeb Architecture](https://raw.githubusercontent.com/ConductionNL/woo-website-template/main/docs/Datamask.svg)

docs/partners/DeVault.md

@@ -1,10 +1,6 @@
 # Koop Hulp(je)
 
-Vanuit de gemeente Buren is Koophulpje.nl opgezet. Het doel van Koophulpje is het doen van een proof of concept (poc) met de OpenWoo.app en het stellen van integrale zoek vragen aan de hand van het federale data stelsel (FSC) en API's.
-
-## Voorgeschiedenis
-
-asd
+Vanuit de gemeente Buren is [Koophulpje.nl](koophulpje.nl) opgezet. Het doel van Koophulpje is het doen van een Proof-of-Concept (poc) met de OpenWoo.app en het stellen van integrale zoekvragen aan de hand van het federale datastelsel (FSC) en API's.
 
 ## Voordelen
 
@@ -16,18 +12,18 @@ asd
 
 - Koophulpje.nl is een 'platte' React pagina, ze beschikt niet over een eigen server, maar maakt direct gebruikt van één API
 - Deze API bevat de gegevens van meerdere gemeenten aan de hand van federale bevraging
-- Ter vergelijking creëren we ook sitemap en robot bestanden voor dezelfde gemeenten t.b.v van de door KOOP voorgestelde harverster
+- Ter vergelijking creëren we ook sitemap en robot bestanden voor dezelfde gemeenten t.b.v van de door KOOP voorgestelde harverster.
 
 ## Bevindingen
 
-Dataveiligheid: Tijdens vroege testen kwam snel naar voren dat het via API de bron bevragen in plaats van het opbouwen van een index een databeveiligheidsverbeteringen opleverde. Foutieve test data kon snel worden verwijderd en was na verwijdering in het bronsysteem geen onderdeel meer van het federale netwerk en daardoor niet meer vindbaar via Koophulpje.
+Dataveiligheid: Tijdens vroege testen kwam snel naar voren dat het via API de bron bevragen in plaats van het opbouwen van een index een verbetering voor de databeveiliging opleverde. Foutieve test data kon snel worden verwijderd en was na verwijdering in het bronsysteem geen onderdeel meer van het federale netwerk en daardoor niet meer vindbaar via Koophulpje.
 Hoewel dit bij het testen vooral fijn was, levert het bij daadwerkelijke productie gang een sterk voordeel op. Het stelt organisaties in staat om gegevens terug te trekken. Bijvoorbeeld bij het per ongeluk publiceren van persoonsgegevens kunnen de gegevens onmiddellijk worden teruggetrokken (i.p.v. dat er moet worden gewacht op de volgende keer data de harvester langs komt).
 
 Schaalbaarheid: Het generen van sitemap.xml-bestanden aan de hand van grotere datasets (1000+) blijkt intensief te zijn
 
-Belasting en kosten: Het genereren van grote sitemap bestanden is server intensief, het confronteert de publicerende overheid daarmee met relatief hoge kosten. We vermoeden dat dit ook geld aan de kant van de harvester.  
+Belasting en kosten: Het genereren van grote sitemap bestanden is server intensief, het confronteert de publicerende overheid daarmee met relatief hoge kosten. We vermoeden dat dit ook geld aan de kant van de harvester.  
 
-Actualiteit: Doordat de sitemap xml bestanden groot zijn blijkt het niet uitvoerbaar om ze bij elke wijziging bij te werken (bijvoorbeeld toegekende vergunning of afgeronde zaak) ipv daarvan worden ze 's nachts gegenereerd. Dit betekent dat het koppelvlak per definitie achterloopt.
+Actualiteit: Doordat de sitemap xml bestanden groot zijn blijkt het niet uitvoerbaar om ze bij elke wijziging bij te werken (bijvoorbeeld toegekende vergunning of afgeronde zaak) i.p.v. daarvan worden ze 's nachts gegenereerd. Dit betekent dat het koppelvlak per definitie achterloopt.
 
 We interpreteren de WOO als alle niet vertrouwelijke gegevens moeten pro-actief openbaar worden gemaakt. Door gebruik te maken van API's in plaats van sitemap xml bestanden zorgen we dat de gegevens alleen worden verstuurd op het moment dat ze worden opgevraagd. Dat vergroot het dataverkeer bij gebruik, maar voorkomt dataverkeer vooraf.
 

docs/partners/Dimpact.md

@@ -1,32 +1,36 @@
 # Dimpact
 
-Dimpact heeft als samenwerkings en inkoop organisatie vanuit diverce van haar leden de vraag gekregen om te verkennen hoe een eventueele in het kader van de Wet open overheid zou kunnen worden vormgegeven. Dimpact heeft deze verkenning in eerste instantie gemeenschappenlijk met de gemeente Rotterdam uitgevoerd.
+Dimpact heeft als samenwerkings- en inkooporganisatie vanuit diverse van haar leden de vraag gekregen om te verkennen hoe een eventuele in het kader van de Wet open overheid zou kunnen worden vormgegeven. Dimpact heeft deze verkenning in eerste instantie gemeenschappelijk met de gemeente Rotterdam uitgevoerd.
 
-Tijdens deze verkenning is Dimpact de oplossing OpenWoo.app tegen gekomen voor het publiceren van Woo verzoeken naar een publicatie pagina én landelijke platformen zo als KOOP. Vanuit hergebruik heeft Dimpact de wens om deze oplossing in te zetten en zich eventueel aan te sluiten bij de OpenWoo.app community.
+Tijdens deze verkenning is Dimpact de oplossing OpenWoo.app tegengekomen voor het publiceren van Woo verzoeken naar een publicatie pagina én landelijke platformen zo als KOOP. Vanuit hergebruik heeft Dimpact de wens om deze oplossing in te zetten en zich eventueel aan te sluiten bij de OpenWoo.app community.
 
 ## Overwegingen
-- OpenWoo.app kent een community van actieve leden waaronder naast gemeentelijke overheden ook provincies, code for nl, open state foundation en het nationaal archief.
+
+- OpenWoo.app kent een community van actieve leden waaronder naast gemeentelijke overheden ook provincies, Code for NL, Open State foundation en het Nationaal Archief.
 - OpenWoo.app heeft een beproefde koppeling met KOOP
 - OpenWoo.app kan publiceren vanuit open zaak.
-- OpenWoo.app maakt hergebruik van binnen Open Catalogi ontwikkelde componenten
-- OpenWoo.app is onderdeel van het commonground portfolio met een rating van zilver
+- OpenWoo.app maakt hergebruik van binnen OpenCatalogi ontwikkelde componenten
+- OpenWoo.app is onderdeel van het Common Ground-portfolio met een rating van goud
 - OpenWoo.app bied naast het zaaksysteem ook werkende koppelingen met andere bronnen
-- OpenWoo.app draaid reeds bij verscheidende overheden in productie
-- OpenWoo.app heeft *geen* annonimiserings component
-- OpenWoo.app heeft *geen* afhandel component voor Woo verzoeken
+- OpenWoo.app draait reeds bij verscheidende overheden in productie
+- OpenWoo.app heeft *geen* annonimiseringscomponent
+- OpenWoo.app heeft *geen* afhandelcomponent voor Woo verzoeken
 
 ## Conclusie
-De OpenWoo.app kan op een goede manier invulling geven aan de publicatie vraag van Dinpact. De reeds gekopelde bronnen geven invulling aan de behoefte van de Dimpact leden en daar waar nieuwe extra bronnen nodig zijn is er een actieve community waarin deze (ook buiten Dimpact om) ontwikkeld kunnen worden. Ook de samenwerking met IO bied Dimpact gemeente een snel implementeerbare route op Open Online richting productie. Het inzetten van de oplossing ligt dan ook voor de hand.
-Echter, naar OpenWoo.app zal Dimpact echter wel zelf moeten faciliteren op het afhandelen en anonimiseren van Woo verzoeken. Dit zal seperaat moeten worden neergezet, zowel Datamask, Mylex als andere markt partijen bieden hier ook losse oplossingen voor aan.  Als alternatief voor deze losse oplossingen zou Dimpact ook kunnen inzetten op afhandeling via haar eigen podium d componenten zo als open formulieren en zaak afhandel component. Voor het annonimiseren zou samenwekring kunnen worden gezocht met de gemeente Buren (OWC) die wil inzetten op een open source annonimiserings tool.
+
+De OpenWoo.app kan op een goede manier invulling geven aan de publicatie vraag van Dimpact. De reeds gekoppelde bronnen geven invulling aan de behoefte van de Dimpact leden en daar waar nieuwe extra bronnen nodig zijn is er een actieve community waarin deze (ook buiten Dimpact om) ontwikkeld kunnen worden. Ook de samenwerking met IO biedt Dimpact gemeente een snel implementeerbare route op Open Online richting productie. Het inzetten van de oplossing ligt dan ook voor de hand.
+Echter, naar OpenWoo.app zal Dimpact echter wel zelf moeten faciliteren op het afhandelen en anonimiseren van Woo verzoeken. Dit zal separaat moeten worden neergezet, zowel Datamask, My-Lex als andere markt partijen bieden hier ook losse oplossingen voor aan.  Als alternatief voor deze losse oplossingen zou Dimpact ook kunnen inzetten op afhandeling via haar eigen Podium D-componenten zo als open formulieren en zaak afhandel component. Voor het annonimiseren zou samenwerking kunnen worden gezocht met de gemeente Buren (OWC) die wil inzetten op een open source annonimiseringstool.
 
 ## Werkzaamheden
-Voor beheer, onderhoud en support kan Dimpact aansluiten bij de huidige community, dit heeft als voordeel dat Dimpact niet alleen minder verantwoordelijkheid naar zich toetrekt maar ook een reeds goedlopende community (financieel) ondersteund en beloond voor haar inspanningen. Dit aanhaken boven overnemen verstevigd het opensource ecosysteem zonder hogere kosten.
+
+Voor beheer, onderhoud en support kan Dimpact aansluiten bij de huidige community, dit heeft als voordeel dat Dimpact niet alleen minder verantwoordelijkheid naar zich toetrekt, maar ook een reeds goedlopende community (financieel) ondersteund en beloond voor haar inspanningen. Dit aanhaken boven overnemen verstevigt het open source ecosysteem zonder hogere kosten.
 
 Voor het traject tót publicatie staat Dimpact echter voor een meer ingewikkelde keuze, kort samengevat zijn er drie opties:
-- De opensource keten overnemen zo als deze bij OWC staat (dat zou de introductie van xxllnc zaak registraties betekenen)
-- Op haar eigen podium d componenten een oplossing vormgeven (dit zou werk voor eigen ontwikkelaars betekeken, en los hiervan een annonimiserings tool onboarden)
-- Een commerciele woo verzoeken afhandelings flow inkopen
+
+- De open source keten overnemen zo als deze bij OWC staat (dat zou de introductie van xxllnc zaak registraties betekenen)
+- Op haar eigen podium d componenten een oplossing vormgeven (dit zou werk voor eigen ontwikkelaars betekenen, en los hiervan een annonimiseringstool onboarden)
+- Een commerciële Woo-verzoeken afhandelingsflow inkopen
 
 ## Opmerkingen
-Het “gat” met betrekking tot de woo afhandeling bestaat alleen voor Woo verzoeken, voor de overige Woo categorieën kan direct worden gepubliceerd vanuit de huidig bronnen. Hier zal een voorziening voor moeten worden getroffen, maar het is goed om in het oog te houden dat deze per definitie tijdelijk is. Het einddoel van de Woo is dat alle relevante informatie pro-actief openbaar word gemaakt. In de context bestaat een verzoek tot openbaar making niet meer.
 
+Het “gat” met betrekking tot de Woo-afhandeling bestaat alleen voor Woo-verzoeken, voor de overige Woo categorieën kan direct worden gepubliceerd vanuit de huidig bronnen. Hier zal een voorziening voor moeten worden getroffen, maar het is goed om in het oog te houden dat deze per definitie tijdelijk is. Het einddoel van de Woo is dat alle relevante informatie pro-actief openbaar wordt gemaakt. In de context bestaat een verzoek tot openbaarmaking niet meer.