2020-09-10 Documenting is designing - How documentation drives better design outcomes
!tags:: #lit✍/📰article #status🚦/🟢green
!links:: Documentation Design
=this.file.name
Reference
Summary
Notes
- Task Perspective v.s. Structural Perspective Documentation
- Task: Documentation that describes in what ways users accomplish tasks
- Structural: Keeps experiences simple and consistent across a range of tasks
- User Stories - deliberately brief and designed to generate discussion
- Use Case - more lengthy and definitive, describing more precisely what the system will do
- Scenario Narratives
- Screen Flow Diagrams
- Page-Level Documentation
- Object Model
- System Vocabulary
- Architecture Map
- Navigational Framework
- Page Archetypes
- Standardized Components
- "The risk of not thinking through (different systems states and the alternative paths they make take) is that your design, once in development, may prove impractical once all conditions must be accommodated."