Issue flow

.github/ISSUE_TEMPLATE/feature.yml → .github/ISSUE_TEMPLATE/Functionaliteit.yml

@@ -1,5 +1,5 @@
-name: Feature request
-description: Request a feature
+name: Functionele vraag
+description: Een vraag over bestaande of nieuwe functionaliteit van een Open Catalogi component
 title: "[feature]: As a user I want ....."
 labels: [feature-request]
 assignees:

README.md

@@ -6,31 +6,45 @@ Open Catalogi bestaad uit drie onderdelen
 3. Projecten de gebruik maken van deze componenten 
 4. Een organisatie die al deze dingen coördineerd
 
-## De Architectuur
-W gaan r vanuit dat een gebruiker bij een interface een zoekvraag steld aan een catalogus, de catalogus maakt vervolgens gebruik van bij hem bekende andere catalogi voor het beantwoorden van de vraag. Het federatief stelsel wordt daarmee gefaciliteerd door catalogi die onderling samenwerken
+**De Architectuur**
+Ww gaan er vanuit dat een gebruiker bij een interface een zoekvraag steld aan een catalogus, de catalogus maakt vervolgens gebruik van bij hem bekende andere catalogi voor het beantwoorden van de vraag. Het federatief stelsel wordt daarmee gefaciliteerd door catalogi die onderling samenwerken
 
 ![UML Diagram van OpenCatalogi](https://raw.githubusercontent.com/OpenCatalogi/.github/main/docs/handleidingen/components_simple.svg "UML Diagram van OpenCatalogi")
 
-Voor een uitgebreide opzet over de interne werking van catalogi kunt u kijken in de [architectuursectie](/docs/handleidingen/Architectuur.md). 
+Voor een uitgebreide opzet over de interne werking van catalogi kunt u kijken in onder [standaard](/Docs/Standaard/). 
 
-## Componenten
+**Componenten**
 Vanuit de Open Catalogi gemeenschap worden een aantal open source componenten onderhouden en ontwikkeld die organisaties helpen met het implementeren van Open Catalogi, de belangrijkste daarvan zijn:
 
 1. Een [nextcloud app](https://github.com/ConductionNL/opencatalogi) faciliteerd een gemakkenlijke omgeving voor opslaan beheren van catalogi en publicaties. (commonground laag 1 & 2)
 2. Een [web app](https://github.com/OpenCatalogi/web-app) faciliteerd de gebruikers interface waarmee kan worden gezocht
 
-Hiernaast hebben verschillende projecten ook nog hun eigen uitbreidingen en matadateringen
+Hiernaast hebben verschillende projecten ook nog hun eigen uitbreidingen en matadateringen, voor meer details kunt u kijken onder [componenten](Docs/Componenten/). 
 
-## Projecten
+**Projecten**
 
 1. Software Catalogus
 2. Generieke datalandschap
 3. OpenWoo.app 
 
-## Organisatie
+Voor meer details kunt u kijken onder [projecten](Docs/Projecten/). 
+
+**Organisatie**
 Open catalogi kent een kerngroep en community, deze gaan gemeenschapenlijk over de standaard en codebases
 
-## Snelle Start
+Voor meer details kunt u kijken onder [organisatie](Docs/Organisatie/). 
+
+**Roadmap**
+
+- Q3 2024
+- Q4 2024
+- Q1 2025
+- Q2 2025
+
+**Vragen/Problemen**
+Heeft u vragen, opmerkingen, aanbevelingen of problemen met de architectuur van Open Catalogi of een van de door Open Catalogi beheerde componenten? Dien hem dan vooral in via [github](https://github.com/OpenCatalogi/.github/issues/new/choose).
+
+**Snelle Start**
 Wil je snel aan de slag met Open Catalogi? Dan zijn er twee gemakkenlijke routes.
 
 1. Via https://opencatalogi.nl/ kan je zoeken binnen het federatieve stelsel van de aangesloten organisaties

docs/Projecten.md

@@ -3,12 +3,34 @@ Naast de generieke organisatie zijn er een aantal project groepen actief met (de
 
 ## Software Catalogus
 **Product Owner**: [Ronald van Cortenberghe](mailto:r.vancortenberghe@rotterdam.nl)(Gemeente Rotterdam)
+Van oorsprong is het Open Catalogi als project begonnen om een alternatief te bieden voor de [commonground componenten catalogus]() (wat later het [portfolio](https://app.powerbi.com/view?r=eyJrIjoiOWU4MjlmYTktNjE2MS00OGRhLTgwMjYtZWZhNTFhZmRhZjI2IiwidCI6IjZlZjAyOWFiLTNmZDctNGQ5OC05YjBlLWQxZjVmZWRlYTZkMSIsImMiOjh9&pageName=ffe4f1f9018d7bd035bc) werdt) waarbij het niet langer noodzakenlijk is om infortmatie te brengen. 
+
+In plaatsdaarvan wordt deze opgehaald aan de hand van een publiccode.yaml bestand dat in de repository wordt geplaats. Makkenlijk kunnen we het niet maken, de codebase maakt daarmee zichzelf kenbaar en vindbaar en alle beschrijving blijft daar waard die hoor, bij de bron (code).
+
+Vanuit dit project wordt beschickbaar gesteld
+
+- Verschillende metadata definities
+    - publiccode
+    - publiccode.service Objecten voor het aanbieden van een service (dienst) op een software pakket
+- Een github catalogus voor applicaties en componenten gevonden op github
+- Een gitlab catalogus voor applicaties en componenten gevonden op github
+- Een componenten catalogus voor commonground beschrijvingen over gevonden componenten
+- Een [git service]() beschickbaarbaar gesteld die automatisch [github]() en [gitlab]() afzoekt naar repositories die een publiccode bevatten en die deze opneemt in de 
 
 ## Generieke datalandschap
 **Product Owner**: [Ronald Kok](mailto:rdw.kok@rotterdam.nl)(Gemeente Rotterdam)
+Het beschickbaar stellen van high value datasets voor de t.b.v. (WHO)[] 
+
+- De metadata defintie DCAT
 
 ## OpenWoo.app 
 **Product Owner**: [Ruben van der Linde](mailto:ruben@conduction.nl)(Conduction)
+Het doorzoekbaar maken van data t.b.v. (WOO)[]
+
+- Verschillende metadata definities
+    - Woo verzoeken en convenanten
+- Een service voor het ophalen van Woo gegevens uit zaaksystemen
+- Een service voor het ophalen van Woo gegevens uit raads informatie systemen
 
 ## Een deel project opstarten
 Wil je zelf aan de hand van open catalogi een eigen project opstarten? en hierbij terugleveren aan de open catalogi gemeenschap? Dan kan je een deel project opstarten. Neem daarvoor contact op met [jaap.vanvliet@dimpact.nl](mailto:jaap.vanvliet@dimpact.nl). Van een deel project verwachten we:

docs/Standaard.md

@@ -31,11 +31,3 @@ Vanuit de gedachte van een federatief stelsel is iedere deelnemer verantwoornlij
 
 Wat OpenCatalogi uniek maakt, is dat de frontend serverless (via GitHub) kan draaien, waardoor deelnemende organisaties OpenCatalogi niet zelf hoeven te installeren om het te kunnen gebruiken. Zowel de frontend als de gegevens kunnen worden gehost op GitHub.
 
-## Varianten
-Hoewel Open Catalogi zich in princiepe leent voor het publiceren van alles (het besschrijft immers alleen een stelsel van samenwerkende catalogi) zien we binnen het poject een aantal varianten naar voren komen:
-
-- **Software catalogus** Van oorsprong is het Open Catalogi als project begonnen om een alternatief te bieden voor de [commonground componenten vatalogus]() waarbij het niet langer noodzakenlijk is om infortmatie te brengen. In plaatsdaarvan wordt deze opgehaald aan de hand van een publiccode.yaml bestand.
-- **OpenWoo.app** Het doorzoekbaar maken van data t.b.v. (WOO)[]
-- **Datacatalogus** Het beschickbaar stellen van high value datasets voor de t.b.v. (WHO)[] 
-
-## Snelle Start