Tip #33

Document disagreement

Takeaways

  • Design decisions aren’t always consensus-based — and that’s fine.
  • Archive unresolved discussions
  • Show rationale behind choices
  • Allow future readers to understand context

🕊️ Transparency is a design value.

Quick action:

Document one unresolved decision thread and link it to the related component page.