Instruction file imported from RoelofvanLeeuwen/ToetsLocking (
.github/instructions/readme.instructions.md). Copyright stays with the author.
README en documentatie instructies
Schrijf documentatie in deze repository in het Nederlands.
Doel
README-bestanden moeten praktisch en direct bruikbaar zijn voor ontwikkeling, setup, beheer en deployment.
Schrijfstijl
- Schrijf helder en concreet.
- Vermijd marketingtaal.
- Leg stappen uit in logische volgorde.
- Benoem aannames expliciet.
- Houd documentatie compact, maar volledig genoeg om zelfstandig mee te werken.
Wat documenteren
Documenteer waar relevant:
- architectuuroverzicht
- projectstructuur
- lokale ontwikkelsetup
- EF Core migrations
- Raspberry Pi setup
- netwerkconfiguratie
- deploymentstappen
- runtime configuratie
- bekende beperkingen en aandachtspunten
Stijlregels
- Gebruik duidelijke koppen.
- Gebruik codeblokken voor commando’s en configuratie.
- Gebruik Nederlandstalige toelichting.
- Geef concrete voorbeelden in plaats van algemene beschrijvingen.
Wat vermijden
- Geen lange theoretische uitleg zonder praktisch nut.
- Geen onnodige herhaling.
- Geen Engelse README’s tenzij expliciet gevraagd.