Hoe deze gids wordt bijgewerkt¶

Deze gids wordt beter van elke vraag. Zo werkt het:

Vraag per e-mail (Een vraag stellen). Een AI-assistent antwoordt op basis van deze gids (alleen deze repo, niets anders).
Signaal. Kon de assistent een vraag niet (zeker) beantwoorden, of meldt iemand dat een antwoord of stap niet klopte? Dan markeert hij een "gat in de gids".
Voorstel (wekelijks). De assistent bundelt de gaten per onderwerp en stelt een wijziging voor: een nieuwe FAQ-vraag (FAQ.md), een aanvulling op een stap of routerkaart, of een nieuw probleem in 90-problemen-oplossen.md.
Goedkeuring. De maker van de gids beoordeelt elk voorstel. Niets komt in de gids zonder menselijke goedkeuring.
Bijwerken. Na goedkeuring krijgt de assistent de nieuwe versie.

Regels voor elke wijziging¶

Geen persoonsgegevens of geheimen: geen namen, e-mailadressen, telefoonnummers, echte IP-adressen, domeinnamen, tunnelnamen, tokens, wachtwoorden, API-sleutels of screenshots daarvan. Gebruik altijd placeholders: jouwdomein.nl, 192.168.1.x, <umbrel-ip>, <JOUW-TOKEN>.
Markeer niet-geverifieerde informatie met ⚠️ Te controleren. Haal die markering pas weg als het in de praktijk is bevestigd. Noteer bij routerkaarten dan model + firmware + maand.
Stappen met risico op dataverlies of internetuitval krijgen 🛑.
Schrijf voor beginners: korte zinnen, één handeling per regel, en een ✅-controlepunt na elke stap.
Nederlands, gewone taal. Vaktermen leggen we uit in woordenlijst.md.

Voor de beheerder: controle op geheimen vóór elke commit¶

# moet niets opleveren behalve placeholders en voorbeeldbereiken
rg -n -i '(token|secret|password|wachtwoord|api[-_]?key)\s*[:=]\s*["'\'']?[A-Za-z0-9_\-]{12,}' .
rg -n '\b(10|172\.(1[6-9]|2[0-9]|3[01])|192\.168)\.[0-9]+\.[0-9]+\b' .