Míváme ve zvyku dokumentovat styleguide pro texty nebo design systém, ale jak dobře dokumentujeme designová rozhodnutí? Kai Wong nabízí jednoduchou osnovu pro zaznamenávání změn v designu:
Use case: Scénář, pro který navrhujeme, včetně kontextu. Jaká jsou best practice v téhle oblasti?
Alternativní možnosti: Jaké varianty jsou pro řešení use case k dispozici.
Rozhodnutí o návrhu: Jak a proč jsme se rozhodli pro zvolenou alternativu.
Rychlá doporučení a tipy: Ukázky, jak návrh použít a jak naopak ne.
Odkazy do dokumentace: Hypertextové odkazy stránku komponenty design systému nebo do styleguide.
Někdy se kolem návrhu stále dokola objevují stejné diskuze. Každý nový stakeholder má tendenci znovu otevírat už uzavřené otázky. Dokumentace nám dovolí efektivně projít připomínkami, vývojářům pomůže pochopit lépe, jak návrh implementovat a v dalších navazujících projektech budeme vědět, co nás dovedlo do situace, kterou řešíme. Dokumentace stejně tak poskytuje prostor pro změny, protože díky ní známe původní podmínky rozhodování a lépe tak dovedeme usoudit, zda nastal čas pro změnu rozhodnutí.
Kai Wong píše, že nejdůležitější je dokumentace v okamžiku, kdy se rozhodneme opustit stávající design systém a nasadit místo něj nový. Tehdy nás dokumentace provede přechodem mezi původními a novými komponentami.