Esborrany editorial publicat per a consulta. La revisió factual i lingüística està pendent. Els exemples són il·lustratius.

Defineix quan s’utilitza

Explica funció, context i casos inadequats. Targeta de servei i alerta poden compartir forma però no significat. Afegeix contingut real. Una biblioteca de formes buides no explica quina decisió ajuda cada peça ni com encaixa amb altres.

Inclou variants i comportament

Documenta càrrega, error, desactivat, focus i text llarg. Defineix parts variables i constants, idiomes i pantalles. Si una variant requereix altra lògica, explica-ho; no permetis combinar opcions visuals que contradiguin el procés.

Prova reutilització independent

Exemple: algú crea una targeta nova amb documentació sense copiar pàgina. Verifica preu, unitat, enllaç i estat amb títol llarg. Accepta si permet instància correcta, detectar combinació invàlida, identificar versió i responsable dels canvis.

Punts clau

  • Documenta decisions i estats perquè reutilitzar conservi el significat.