Skip to content

docs: use discrete for background progress#9666

Open
Rohan5commit wants to merge 1 commit intomicrosoft:mainfrom
Rohan5commit:docs-status-bar-discrete-20260418
Open

docs: use discrete for background progress#9666
Rohan5commit wants to merge 1 commit intomicrosoft:mainfrom
Rohan5commit:docs-status-bar-discrete-20260418

Conversation

@Rohan5commit
Copy link
Copy Markdown
Contributor

Summary

  • fix status bar guidance to use discrete for background progress wording

Related issue

  • N/A (trivial docs wording fix)

Guideline alignment

  • reviewed CONTRIBUTING.md
  • kept the change to one docs file with no behavior impact

Validation

  • git diff --check

Copilot AI review requested due to automatic review settings April 18, 2026 02:09
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

Updates the Status Bar UX guideline to use the correct term discrete (not discreet) when describing background progress, keeping the guidance accurate and consistent.

Changes:

  • Replace “discreet” with “discrete” in the background progress guidance text.
  • Replace “discreet” with “discrete” in the accompanying example caption.

### 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.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants