Omni Core · UI and UX Optimization · Module

Design decisions

What is being changed and why, with the reasoning recorded so a later change does not undo it for reasons nobody remembers.

The idea

How it works

Undocumented design decisions get reversed. Someone new sees an odd arrangement, improves it, and reintroduces the problem it was solving.

Consistency is worth more than local optimisation. A pattern that is slightly worse everywhere but the same everywhere outperforms a set of individually optimised inconsistencies.

Working with it

In practice

  1. 01

    Record the reason, not the decision

    What problem the arrangement solves. The decision is visible in the interface; the reason is not.

  2. 02

    Prefer the existing pattern

    A new pattern has to be better by enough to justify the inconsistency, which is a high bar.

  3. 03

    Note what was tried and failed

    The obvious improvement has usually been attempted. Recording why it failed saves it being attempted again.

  4. 04

    Keep the rationale near the design

    In the design system rather than in a document nobody opens.

One level in

The components of design decisions

A component is something that exists afterwards which did not exist before — a deliverable or a mechanism, not an intention.

  1. The decision

    What was chosen.

    Learn
  2. The rationale

    What problem it solves, which the interface cannot show.

    Learn
  3. The rejected

    What was tried and did not work.

    Learn

The obvious improvement has usually already been tried. Recording why it failed prevents it being tried again.