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 |
| Google Workspace | 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.
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
De wiki draait op een Google Cloud-omgeving en moet daar weg. Dit is het meest concrete punt op deze pagina. 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.
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
- Bevestigt de kring de opdracht zoals hierboven beschreven, als beschrijving van de bestaande praktijk?
- Wie is achtervang per omgeving, zodat beheer niet op één persoon rust?
- 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.
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.
- Toepassingen op Nuts. De FHIR IG-builds van de toepassingen draaien op onze GitHub-omgeving.
- Vernieuwing van de technische documentatie. Het procesvoorstel van het COT raakt de keuze voor tooling en structuur van de documentatie.
- 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.