Altijd up to date documentatie met maximaal descriptieve tests
Niemand houdt van documentatie schrijven - en terecht! Documentatie schrijven en onderhouden kost veel energie. Tegelijkertijd wordt het nauwelijks gelezen en veroudert snel. Toch is documentatie een belangrijke hulpbron voor (nieuwe) ontwikkelaars om snel up to speed te komen over de werking van een codebase.
Moeten we daarom door de zure appel heen bijten, en weer gaan zwoegen op uitgebreide specificatiedocumenten? Gelukkig niet! Tests bieden een uitkomst. Door extra aandacht te besteden aan de scope en leesbaarheid van je tests, kun je deze transformeren van eenvoudig validatiemechanisme naar gezaghebbende bron van informatie voor ontwikkelaars. Met maximaal descriptieve tests is je documentatie altijd up to date.
Wanneer?
- Nimma Codes, 28 februari 2023 (foto’s)
- TestNet Voorjaarsevenement, 9 mei 2023
- DomCode, 12 maart 2024 (foto’s)
- TopiConf, 13 juni 2024
Gerelateerde blogs
- Tests als documentatie
- Tests zijn specs
- Testen via de voordeur
- Test het systeem, niet de class
- Wat is een unit?
- Waarom DRY? Waarom DAMP?
- Droger tests met factory methods