Community-tooling en samenwerkingsmiddelen

Status: loopt Waar: #kring-techniek-aanspreekpunt

Wat het is

De kring ondersteunt de community met de middelen die samenwerking en kennisdeling mogelijk maken: de wiki, de website, de code-repositories, de project-boards, Slack en de bijbehorende accounts, domeinen en certificaten. Dit staat als doorlopend werk in het jaarplan en volgt uit punt 3 en punt 5 van het mandaat.

Deze pagina is een reconstructie van de bestaande praktijk. Het is een beschrijving van wat er is en wat er gebeurt, geen voorstel tot verandering.

Overzicht van de middelen

Middel	Waar het draait	Waarvoor	Beheer
Wiki	BookStack op Google Cloud	Kringpagina's, documentatie en overzichten	Steven van der Vegt
Website	GitHub Pages	Publieke informatie over Nuts	Rein Krul, ondersteunend aan de kring Gezamenlijk Belang
Code-repositories	GitHub	Broncode, specificaties, issues en de FHIR IG-builds van de toepassingen	Steven van der Vegt (toegang en security)
Project-boards	GitHub	Backlog en voortgang per project	volgt de repositories
Docker Hub	Docker Hub	Publicatie van de images	Rein Krul en Steven van der Vegt
Slack	Slack	Dagelijkse samenwerking en community-kanalen	Steven van der Vegt
Specificaties en RFC's	GitBook	RFC's, bolts en leveranciersspecificaties	Steven van der Vegt
Node-documentatie	Read the Docs	Deployment- en beheerdocumentatie van de nuts-node	Steven van der Vegt (omgeving), inhoud volgt het producteigenaarschap
Zorgtoepassingenkompas	Vercel, met Supabase	Overzicht van de status en voortgang per zorgtoepassing	Edwin de Wit
Google Workspace	Google	Mailboxen, Docs en Drive	Steven van der Vegt
Domeinnamen, DNS en certificaten	TransIP als registrar	nuts.nl en bijbehorende subdomeinen, de DNS-records en de certificaten daarvoor	Steven van der Vegt

Van deze middelen zijn Google Workspace, Google Cloud en de domeinnamen betaald. De overige omgevingen zijn kosteloos in gebruik omdat onze software open source is.

Het Zorgtoepassingenkompas is nog in draft en loopt voorlopig als losse app. De vraag of het samengaat met nuts.nl/toepassingen ligt bij de kring Gezamenlijk Belang, omdat de website hun domein is; het onderhoud raakt deze kring.

Opdracht

Doel. Werkende, veilige en toegankelijke samenwerkingsmiddelen voor de community, met duidelijk beheer en zonder onnodige afhankelijkheden.

Scope. De opdracht omvat:

• Beheer en beschikbaarheid van de middelen hierboven, inclusief het oplossen van storingen
• Toegangsbeheer: wie heeft toegang tot welke omgeving, en het herstellen of intrekken daarvan
• Security op de omgevingen, waaronder de eisen aan twee-factor-authenticatie op de GitHub-organisatie en het rechtenbeheer op de repositories
• Accounts, abonnementen, domeinnamen, DNS en certificaten, inclusief tijdige verlenging en betaling
• Inrichting en structuur van de wiki en de kanalen, zodat informatie vindbaar blijft
• Ondersteuning aan de andere kringen bij het gebruik van deze middelen

Buiten scope valt de inhoud die in deze middelen wordt gepubliceerd. Elke kring en elke opdracht is zelf verantwoordelijk voor de eigen pagina's, documentatie en berichten. De website is daarvan het duidelijkste voorbeeld: het domein communicatie en website ligt bij de kring Gezamenlijk Belang, wij leveren de technische ondersteuning. Ook de PKIoverheid- en UZI-certificaten die deelnemers voor hun eigen node gebruiken vallen hier niet onder; dit gaat om de certificaten van onze eigen omgevingen.

Resultaat. Doorlopend werk zonder einddatum.

Belegging. Zie de kolom Beheer in het overzicht hierboven.

Werkwijze. Verzoeken en storingen komen binnen via #kring-techniek-aanspreekpunt en rechtstreeks bij de beheerders. Waar een wijziging wordt aangekondigd, hangt af van wie hem merkt: bij de gebruikers van de betreffende tool, in #general als het de hele community raakt, en in de kring als het om beleid of om een structurele verandering gaat. Voor de website loopt de afstemming via #website, samen met de kring Gezamenlijk Belang.

Recent beleid

• Twee-factor-authenticatie op de GitHub-organisatie moet via een veilig middel. Sms is niet toegestaan. (april 2026)
• Rechten op repositories zijn aangescherpt. Wie toegang mist die eerder wel bestond, vraagt die aan bij de beheerder. (mei 2026)

Aandachtspunten

Het Slack Pro-abonnement loopt af rond half november 2026. Eerder is besloten niet te verlengen. Er zijn drie richtingen: overgaan op het gratis plan en de historie grotendeels kwijtraken, alsnog betalen, of zelf een open source alternatief hosten zoals Mattermost of Matrix. De afweging is niet alleen financieel: de workspace heeft ruim 900 leden, terwijl een overstap naar een eigen omgeving realistisch door zo'n 60 mensen gevolgd zou worden. Dit valt onder ons mandaat, maar raakt de hele community en vraagt dus toetsing daar.

De wiki draait op een Google Cloud-omgeving en moet daar weg. Wat daarvoor nodig is: een keuze voor de nieuwe omgeving, een migratiepad met behoud van de inhoud en de links, en helderheid over wie de omgeving daarna beheert en betaalt. Vanuit project GF ligt erloopt een memoeigen van Rein Krul (28 augustus 2026, work in progress)keuze voor een sandbox-omgevinghostingprovider, bijzie OVHcloud,Hosting geschatvan opde 100 tot 150 euro per maand.GF-testomgeving. Die memo noemt hosting van andere Nuts-brede diensten, waaronder de wiki, als mogelijke toekomstige uitbreiding, maar datomgeving is nu uitdrukkelijk niet het doel vanuit project GF. Het is dus geen oplossing voor de wiki, maar kan er wel een omgeving die daarvoorvoor in beeld kan komen.

Afhankelijkheid van Google. Naast de wiki lopen ook de mailboxen, Docs en Drive via Google Workspace. Dat is geen acuut probleem, maar het is de moeite waard om te weten wat de afhankelijkheid is en wat een alternatief zou kosten, mede gezien de uitgangspunten van Nuts.

Beheer hangt op enkele personen. Vrijwel alle omgevingen worden door één persoon beheerd. Er is geen achtervang vastgelegd. Bij domeinnamen, DNS en certificaten weegt dat zwaarder dan elders, omdat een gemiste verlenging direct zichtbaar is voor de hele community.

Te besluiten

1. Bevestigt de kring de opdracht zoals hierboven beschreven, als beschrijving van de bestaande praktijk?
2. Wie is achtervang per omgeving, zodat beheer niet op één persoon rust?
3. Waar gaat de wiki naartoe, en wie werkt dat uit? Voorstel is dit als aparte opdracht te beleggen, met een voorstel terug in de kring.
4. Wat doen we met Slack als het Pro-abonnement afloopt, en hoe toetsen we dat bij de community? Dit vraagt een besluit ruim voor half november.

Samenhang met andere trajecten

• Beheer en doorontwikkeling nuts-node. De repositories, Docker Hub en de node-documentatie worden gebruikt vanuit die opdracht; het beheer van de omgevingen zelf valt hier.
• GeneriekeHosting Functiesvan de GF-testomgeving. De hostingkeuze voor de GF-sandbox raakt de vraag waar wij onze eigen omgevingen onderbrengen.
• Toepassingen op Nuts. De FHIR IG-builds van de toepassingen draaien op onze GitHub-omgeving.
• Vernieuwing van de technische documentatie.documentatie. Het procesvoorstel van het COT raakt de keuze voor tooling en structuur van de documentatie.
• Toepassingen op Nuts. De FHIR IG-builds van de toepassingen draaien op onze GitHub-omgeving.
• Kring Gezamenlijk Belang. Die kring heeft het domein communicatie en website; de samenwerking daarover loopt via #website.

Hoe haak je aan

Mis je toegang, werkt iets niet, of wil je meehelpen aan het beheer van een van deze middelen, laat het weten in #kring-techniek-aanspreekpunt.