How documentation drives better design outcomes | WalkingTree Technologies

In the early stages of design thinking, it’s important to sketch. But once moving beyond the concept, a design must be well-reasoned, particularly if you are designing applications. This “reasoning” would be done by a business analyst. But that might not always be the case, designers need to be prepared to take on this task.

One of the best ways to ensure a design is well-reasoned is to be “forced” to describe it verbally. The “documentation is designing” approach obviates the need for a big documentation pass. The benefit of integrating documentation into your design practice helps build explanatory writing skills.

Type of Design Documentation

When creating a design, look at a system from two perspectives: the structural perspective and the task perspective:

Task Perspective includes:

  • User Stories: User stories are brief and designed to generate discussion.
  • Use Cases: Use cases are more lengthy and definitive, describing more precisely what the system will do.
  • Scenario Narratives: They provide more descriptive details about how a set of tasks are performed.
  • Screen Flow Diagrams: Shows how users move screen-to-screen, can vary from simple flows to more comprehensive diagrams.
  • Page-Level Documentation: An overview of the function of the page and Step-by-step instructions for any interactive demos.

Structural Perspective includes:

  • Object Model: Similar to the way that flow diagrams provide a 30,000 ft view. The object model shows that view from a structural standpoint
  • System Vocabulary: It can be helpful to explicitly document system vocabulary.
  • Architecture Map: Its goal is to communicate how the application is structured and represents the information hierarchy.
  • Page Archetypes: They are specific genres of pages that share layout characteristics.
  • Standardized Components: Includes elements that are shared across the breadth of a web site or system.

to know more about documentation and how design thinking can help.

Originally published at https://walkingtree.tech on September 15, 2020.

WalkingTree is an IT software and service provider recognized for its passion for technology.