```suggestion
A [progress bar](https://clarity.design/documentation/progress) is a linear indicator that shows the progress of an ongoing, user-initiated process. Progress bars are designed for us...
what about:
Design teams **May** use a progress bar as an alternative to a spinner if more space is available. Progress bars are preferable when the progress status is known, while spinners are...
```suggestion
There are two types of layouts: horizontal and vertical.
```
Inline code isn't necessary for this. This is not code documentation. Please update all.
Design teams **Should** use appropriate [toggle switch states](https://clarity.design/documentation/toggle-switch#states) to ensure clarity and align with user expectations.
Design teams **Must Not** use this pattern for options that require descriptions to explain the implications of both the on and off states. Switches are for simple toggles, so for more detailed cho...
```suggestion
- **Should** use a verb phrase to describe the action represented by the icon; for example, “Edit settings”
```
Previous guidance says no ending punctuation.
Design teams **Must Not** use this pattern for options activated upon form submission, like Terms and Conditions. Switches imply immediate action, so for deferred actions (such as form submission),...
```suggestion
- **Should** choose a [tooltip position](https://clarity.design/documentation/tooltip#placement) that ensures the entire tooltip is visible on the screen and the tooltip does not cov...