Introduce Decision Matrix?

[Jan-Eimertenbrink]

Problem

With the development of initial extensions and related discussions, I've noticed that contributors often struggle to determine which control is best suited for their use case. For example, the question often arises whether to use a switch, a checkbox, or a radio button. These types of decisions come up frequently when developing an extension. With our Styleguide, we aim to support contributors in making these choices by clearly indicating the preferred options for specific scenarios. To achieve this, we are planning to include text-based guidelines as well as examples in the form of code templates.

Idea

In addition to these resources, decision matrices could also be helpful – in line with the saying, "A picture is worth a thousand words." A decision matrix would allow contributors to navigate through a visual guide, making it easier to understand how our design system should be applied.

Possible areas where a decision matrix could be beneficial:

• Choosing a control
• Deciding between a list, table, or tile layout
• Choosing between a modal or off-canvas option
• Selecting between a badge or an alert badge

Examples from other Design Systems:

• Primer SegementedControl