Usklađenost između dema i specifikacije
Usklađenost između dema i specifikacije praksa je održavanja dosljednosti između ponašanja prototipa ili dema i dokumentirane namjere proizvoda, uz eksplicitno ažuriranje specifikacije kada demo pokaže bolji tijek rada.
Zašto je važna
Demo je koristan jer tijekove rada čini konkretnima. Rizik nastaje kada ljudi vidljivo ponašanje počnu tretirati kao odobrenu proizvodnu istinu iako dokumentacija nije ažurirana.
Preporučeni redoslijed autoriteta
- proizvodna specifikacija
- implementacijske smjernice
- dokumentacija trenutačnog stanja
- demo ili ponašanje implementacije
- validacija i testovi
To ne znači da demo nije važan. Znači da ga treba tumačiti unutar dokumentiranog sustava odluka.
Zdrava upotreba dema
Demo koristite za:
- otkrivanje problema u tijeku rada
- otkrivanje problema upotrebljivosti
- provjeru pretpostavki s korisnicima
- objašnjenje dionicima
Demo ne treba koristiti kao tihu zamjenu za proizvodne odluke.
Kada demo treba voditi
Ako demo pokaže očito bolji tijek rada, tim treba:
- namjerno pregledati promjenu
- ažurirati relevantnu specifikaciju i dokumentaciju
- prilagoditi validaciju ili očekivanja pregleda
Drugim riječima, demo može nadahnuti sljedeću odluku, ali ažurirana odluka i dalje mora biti dokumentirana.
Kontekst Let Books
U repozitoriju Let Books kanonski dokumentacijski izvori već su odvojeni od statusa implementacije. To je korisna zaštita jer sprječava da prototipi postanu slučajni urednički autoritet.