Design Documentatie

Heldere documentatie van designkeuzes voor een soepelere samenwerking met developers.

Het onderdeel dat meestal wordt overgeslagen, en de reden dat designintentie stilletjes verdwijnt in de bouw. We documenteren waarom een ontwerp werkt zoals het werkt, specificeren de componenten, definiëren de interacties en — vooral — schrijven de randgevallen op: leeg, laden, fout, te veel content, geen rechten. Juist op die toestanden loopt een overdracht in de praktijk stuk.

Gebruikelijke doorlooptijd: Meestal 5–10 dagen

Voor wie dit is

• Developers blijven vragen wat er moet gebeuren als het misgaat
• Wat er live gaat komt niet overeen met wat er ontworpen is
• Je team groeit en de intentie zit in één hoofd

Veelgestelde vragen

Kunnen jullie een bestaand ontwerp documenteren?

Ja, en dat komt vaak voor. We reconstrueren de intentie met je team en leggen die vast voordat hij verdwijnt.

Waar komt het te staan?

Naast je designbestanden of in de documentatietool die je team al gebruikt — waar je developers toch al kijken.

Hoort dit bij een designsysteem?

Het overlapt. Een systeem zonder documentatie is een componentbibliotheek; de documentatie maakt er een systeem van.