Merge remote-tracking branch 'origin/feature/docs-03112023' into feat…

…ure/docs-03112023

README.md

@@ -2,32 +2,32 @@
 
 > **WOObinar op 15 November**
 >
-> 
+>
 > Meer weten over deze oplossing? Dat kan!
 >
 >
-> De leverancier [xxllnc](https://xxllnc.nl/) organiseerd op 15 november 13:00 een [WOObinar](https://www.linkedin.com/events/woobinar7125512622950494208/comments/), inschrijven kan [hier](https://www.linkedin.com/events/woobinar7125512622950494208/comments/). Tijdens deze bijeenkomst wordt zowel deze oplossing toegelicht als dat er de mogelijkheid is voor het stellen van (technische) vragen. 
+> De leverancier [xxllnc](https://xxllnc.nl/) organiseerd op 15 november 13:00 een [WOObinar](https://www.linkedin.com/events/woobinar7125512622950494208/comments/), inschrijven kan [hier](https://www.linkedin.com/events/woobinar7125512622950494208/comments/). Tijdens deze bijeenkomst wordt zowel deze oplossing toegelicht als dat er de mogelijkheid is voor het stellen van (technische) vragen.
 
 De Wet Open Overheid (WOO) is een initiatief gericht op het verbeteren van de openbaarheid van overheidsinformatie. Het doel is om overheidsinformatie beter toegankelijk te maken voor iedereen. Meer informatie over de Wet Open Overheid kan [hier](https://www.open-overheid.nl/themas/wet-open-overheid/) worden gevonden.
 
 De implementatie van de Wet Open Overheid brengt twee kernuitdagingen met zich mee:
 
 1. **Diversificatie van Publicatie Typen:**
-   Met de tijd zullen er steeds meer typen van publicaties ontstaan, variërend van rapporten en besluiten tot datasets en onderzoeksresultaten. Deze diversiteit vereist een flexibel systeem dat in staat is om verschillende typen van publicaties adequaat te hanteren. Dat maakt het op voorhand onmogenlijk om één bron (zoals zaaksysteem of raadsinformaite syteem) richting de toekomst aan te wijzen.
+   Met de tijd zullen er steeds meer typen van publicaties ontstaan, variërend van rapporten en besluiten tot datasets en onderzoeksresultaten. Deze diversiteit vereist een flexibel systeem dat in staat is om verschillende typen van publicaties adequaat te hanteren. Dat maakt het op voorhand onmogelijk om één bron (zoals zaaksysteem of raadsinformatiesyteem) richting de toekomst aan te wijzen.
 
 2. **Proactieve Publicatie:**
-   Overheden moeten informatie proactief te publiceren. Dit betekend dat publicatie onderdeel moet worden van het normale werkprocces. Hiermee is het richting de toekomst niet haalbaar om WOO publicaties handmatig via een appart systeem (bijvoorbeeld CMS website) te laten verlopen.
+   Overheden moeten informatie proactief te publiceren. Dit betekent dat publicatie onderdeel moet worden van het normale werkproces. Hiermee is het richting de toekomst niet haalbaar om Woo-publicaties handmatig via een apart systeem (bijvoorbeeld CMS website) te laten verlopen.
 
 ## Probleemstelling
 
 Deze uitdagingen kunnen niet effectief worden aangepakt met een enkel Content Management Systeem (CMS) of door levering vanuit één systeem. Handmatige publicatie van alle overheidsinformatie zou een aanzienlijke personele inzet vereisen, wat onpraktisch is. Daarbij komt dat de verscheidenheid aan publicatietypen vaak verdeeld is over meerdere systemen, wat de situatie verder compliceert.
 
 ## Oplossing
 
-De Open WOO APP biedt een geïntegreerde oplossing die bestaat een aantal hoofdcomponenten:
+De Open WOO APP biedt een geïntegreerde oplossing die bestaat uit een aantal hoofdcomponenten:
 
-1. **Koppelvlak naar COOP en WOOGLE voor de Landelijke Index:**
-   Een interface die zorgt voor een gestandaardiseerde verbinding met de Collectieve Opdrachtverlening Overheidspartijen (COOP), waardoor een landelijke index van overheidsinformatie wordt gecreëerd.
+1. **Koppelvlak naar KOOP en WOOGLE voor de Landelijke Index:**
+   Een interface die zorgt voor een gestandaardiseerde verbinding met de [Kennis- en Exploitatiecentrum en Officiële Publicaties](https://www.koopoverheid.nl/)(KOOP), waardoor een landelijke index van overheidsinformatie wordt gecreëerd.
 
 2. **Organisatieweergave:**
    Een interface waarmee belanghebbenden binnen een organisatie naar relevante informatie kunnen zoeken.
@@ -40,15 +40,14 @@ De Open WOO APP biedt een geïntegreerde oplossing die bestaat een aantal hoofdc
 
 Deze geïntegreerde aanpak zorgt voor een naadloze, efficiënte en effectieve implementatie van de Wet Open Overheid, waardoor overheidsorganisaties hun informatie op een gebruiksvriendelijke en toegankelijke wijze kunnen delen.
 
-
 ## Functionaliteiten
+
 - Één index pagina voor uw organisatie
 - Weergave van data uit meerdere bronnen (zaaksysteem, website, raadsinformatie systeem en archief)
-- Aanlevering bij KOOP aan de hand van sitemap.xml bestanden
+- Aanlevering bij KOOP aan de hand van `sitemap.xml`-bestanden
 - Automatisch en pro-actief publiceren
 - Op de toekomst voorbereid
 
-
 ![epe.png](https://raw.githubusercontent.com/ConductionNL/woo-website-template/main/docs/epe.png "Woo Website van de Gemeente Epe")
 
 ## Opzet
@@ -66,23 +65,12 @@ Meer details hierover vindt u onder [architectuur](/docs/Architectuur.md).
 
 ![Website Architecture](https://raw.githubusercontent.com/ConductionNL/woo-website-template/main/docs/components.svg "Website Architecture")
 
-
 Dit is een zelfstandig bruikbare uitbreiding op [Open Woo](https://github.com/OpenWebconcept/plugin-openwoo) van het [Open Webconcept](https://openwebconcept.nl/). Het maakt hergebruik van [NL Design (React componenten)](https://nldesignsystem.nl/meedoen/introductie) om aan de hand van [Design Tokens](https://nldesignsystem.nl/meedoen/design-tokens/) gemeentelijk specifieke [Woo-index](https://www.koopoverheid.nl/voor-overheden/rijksoverheid/woo-index) pagina's te genereren die voldoen aan alle [WCAG](https://wcag.nl/kennis/richtlijnen/) en [wettelijke eisen](https://www.rijksoverheid.nl/onderwerpen/wet-open-overheid-woo).
 
-
-### Woo 1.0
-
-Voor de eerste opzet van de Woo-index van BZK is het belangrijk dat organisaties zelf hun Woo-publicaties op een doorzoekbare index publiceren. BZK houdt vervolgens een overzichtspagina bij waarop per organisatie de algemene organisatiegegevens en de organisatiespecifieke indexpagina vindbaar zijn.
-
-### Woo 2.0
-
-BZK heeft de ambitie om aan de hand van een harvester een eigen index op te bouwen op open.overheid.nl. Deze harvester maakt gebruik van `robots.txt` en `sitemap.xml`-bestanden om de verschillende pagina's en metadata van de organisatiespecifieke index te vinden en over te nemen. Dat betekent dat ook binnen de 2.0 variant van Woo een eigen indexpagina noodzakelijk blijft. Sterker nog, de kwaliteit van de ontsluiting wordt in grote mate afhankelijk van de kwaliteit van de index.
-
 ### Open versus Woo
 
 De Woo specificeert een aantal categorieën (zie configuratie) die door een organisatie moeten worden ontsloten. Dit template ondersteunt dat, maar gaat een stap verder door organisaties ook categorieën te laten toevoegen. Hierdoor kan bredere invulling worden gegeven aan het concept "open" en kunnen bijvoorbeeld ook datasets of algoritmes worden ontsloten.
 
-
 ## Voorbeelden
 
 | Organisatie | Woo Pagina | Woo Bron(en) |
@@ -103,3 +91,7 @@ De Woo specificeert een aantal categorieën (zie configuratie) die door een orga
 - [Roadmap](docs/Roadmap.md)
 - [Configuratie](docs/Configuratie.md)
 - [Testscenario's](docs/Tests.md)
+
+## Toekomstplannen
+
+Er komen steeds meer toepassingen voor het publiceren van overheidsinformatie. Denk bijvoorbeeld aan het publiceren van datasets, algoritmes en besluiten. Deze toepassingen zullen in de toekomst ook onderdeel worden van de Wet Open Overheid. Daarom is het belangrijk dat de Open WOO App flexibel is en kan worden aangepast aan de veranderende behoeften van de overheid. Kijk voor meer informatie over onze ontwikkelplannen op de [roadmap](./docs/Roadmap.md)

docs/Architectuur.md

@@ -10,7 +10,7 @@ Toegepaste norm: [NL API Strategie over property namen](https://docs.geostandaar
 
 ### Open Webconcept variant
 
-Met deze variant kunnen Woo-verzoeken en convenanten eenvoudig worden beheerd vanuit de bestaande webomgeving en CMS door middel van de Open Webconcept plugin. Dit vereist geen extra installatie of beheerinspanningen van de organisatie, op voorwaarde dat er al een OpenWebconcept-installatie met de benodigde plugins beschikbaar is. Dit biedt een serverloze en kostenefficiënte oplossing door het hergebruik van bestaande Common Ground-componenten.
+Met deze variant kunnen Woo-verzoeken en convenanten eenvoudig worden beheerd vanuit de bestaande webomgeving en CMS door middel van een directe koppeling met de gateway. Dit vereist geen extra installatie of beheerinspanningen van de organisatie, op voorwaarde dat er al een OpenWebconcept-installatie met de benodigde plugins beschikbaar is. Dit biedt een serverloze en kostenefficiënte oplossing door het hergebruik van bestaande Common Ground-componenten.
 
 **Nadelen:**
 
@@ -40,3 +40,31 @@ De Open Woo-plugin "scraped" elke nacht alle relevante zaken. De stappen zijn al
 5. Zaken die niet zijn gevonden in bovenstaande loop maar wel in de index staan, worden verwijderd.
 
 Dit proces zorgt ervoor dat het zaaksysteem leidend is en dat zaken zowel kunnen worden gepubliceerd als gedepubliceerd.
+
+## Federatie via OpenCatalogi
+
+OpenWoo.app maakt gebruik van het federatieve stelstel van OpenCatalogi om de verschillende varianten te kunnen ontsluiten. Dit betekent dat organisaties zelf kunnen bepalen welke variant ze willen gebruiken en dat ze niet afhankelijk zijn van een centrale partij.
+
+## Landelijke API
+
+Iedereen kan de landelijke API bevragen om alle Woo-verzoeken en convenanten op te halen. De landelijke API is te vinden op []() . De API is gebaseerd op de [NL API Strategie](https://docs.geostandaarden.nl/api/cv-hr-API-Strategie-20190213/). De API is te bevragen via de volgende endpoints:
+
+## Componenten
+
+Een variant bestaat uit een aantal componenten die samen de functionaliteit van de variant vormen. Deze componenten zijn:
+
+- [Woo API]()
+- [Woo Website]()
+- [Woo Plugin]()
+- [Woogle](https://woogle.wooverheid.nl/search?q=*)
+- [Raadsinformatie Systeem]()
+- [KOOP-index]()
+- [Common Gateway]()
+- [Open Webconcept CMS]()
+- [Zaaksysteem]()
+
+Alle componenten worden getest met [zaaksysteem.nl](https://xxllnc.nl/zaakgericht/), Rx.Fundament en Decos JOIN
+
+## Roadmap
+
+Organisaties kunnen bijdragen aan de ontwikkeling van deze componenten door items aan te dragen, deze zelf op te pakken en uit te voeren, of door de uitvoering ervan te financieren. Voor het huidige overzicht, zie [Roadmap](/docs/Roadmap.md).