Skip to content

docs: use discrete for background progress #9666

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
Rohan5commit wants to merge 1 commit into
base: main
Choose a base branch
from
+2 −2
Open

docs: use discrete for background progress #9666

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions api/ux-guidelines/status-bar.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -35,11 +35,11 @@ The [Status Bar](/api/extension-capabilities/extending-workbench#status-bar-item

### Progress Status Bar item

When needing to show discreet progress (progress happening in the background), it's recommended to show a Status Bar item with the loading icon (you can also add spin animation). If progress needs to be elevated for user attention, we recommend moving to a progress notification.
When needing to show discrete progress (progress happening in the background), it's recommended to show a Status Bar item with the loading icon (you can also add spin animation). If progress needs to be elevated for user attention, we recommend moving to a progress notification.
Copy link

Copilot AI Apr 18, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This sentence is hard to parse and is not in second person. Consider rewriting to a direct instruction (for example, start with "When you need to show..." and avoid "it's recommended").

Suggested change
When needing to show discrete progress (progress happening in the background), it's recommended to show a Status Bar item with the loading icon (you can also add spin animation). If progress needs to be elevated for user attention, we recommend moving to a progress notification.
When you need to show discrete progress, or progress that happens in the background, show a Status Bar item with the loading icon. You can also add a spin animation. If you need to elevate progress for user attention, move it to a progress notification.

Copilot uses AI. Check for mistakes.

![Status Bar Progress](images/examples/status-bar-progress.png)

*This example shows a progress Status Bar item that is discreet.*
*This example shows a progress Status Bar item that is discrete.*
Copy link

Copilot AI Apr 18, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The caption uses "discrete", which many readers confuse with "discreet". Consider rephrasing the caption to avoid the ambiguous word (for example, describe it as "background" progress) since the section already defines the concept.

Suggested change
*This example shows a progress Status Bar item that is discrete.*
*This example shows a progress Status Bar item that shows background progress.*

Copilot uses AI. Check for mistakes.


### Error and Warning Status Bar Items
Expand Down
Loading