Tip #17

Describe intent, not just code

Takeaways

  • Design is meaning. Show it.
  • Explain design choices
  • Clarify edge cases
  • Show when not to use a component

🎯 Good documentation reduces cognitive overhead.

Quick action:

Add a “when not to use this” bullet to one of your most-used components.

Suggested ressource:

Carbon Design System