Skip to content

Conversation

AvishekDas5
Copy link
Contributor

Summary

Add comprehensive documentation explaining Windows Terminal's color naming scheme and relationship to ECMA-48 standards.

Problem Solved

Users are frequently confused by color names like brightBlack and brightWhite which seem contradictory at first glance. This documentation provides clear explanations and practical examples to resolve this confusion.

Changes Made

  • Color reference table with all 16 color names, indexes, RGB values, and descriptions
  • Practical usage examples including complete working color schemes
  • Common questions section addressing specific confusion points like "Why is brightBlack not black?"
  • Comparison table with .NET ConsoleColor enum for developers migrating from .NET
  • Historical context explaining ECMA-48 standard background
  • Step-by-step instructions for applying color schemes

Key Features

  • User-first approach: immediate answers before background information
  • Complete copy-paste examples for practical use
  • Visual color swatches in reference table
  • Conversion guide for .NET developers
  • Addresses the main user confusion points identified in the issue

Validation

  • Explains why brightBlack = dark gray (not contradiction)
  • Clarifies white vs brightWhite distinction
  • Provides practical JSON examples
  • Includes complete working color scheme
  • Addresses .NET ConsoleColor comparison request
  • Follows user-focused documentation structure

Closes #2641

Updated the color scheme explanation to include a color index and revised the color names table format.
Updated instructions for using the color scheme in Windows Terminal.
@microsoft-github-policy-service microsoft-github-policy-service bot added Issue-Docs It's a documentation issue that really should be on MicrosoftDocs/Console-Docs Area-Settings Issues related to settings and customizability, for console or terminal Product-Terminal The new Windows Terminal. labels Sep 28, 2025
@AvishekDas5
Copy link
Contributor Author

@microsoft-github-policy-service agree

Copy link
Member

@DHowett DHowett left a comment

Choose a reason for hiding this comment

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

Thanks! We'll have to have a discussion internally to see how we feel about this and if it should be a public document rather than just one in the repository.

@microsoft-github-policy-service microsoft-github-policy-service bot added the Needs-Author-Feedback The original author of the issue/PR needs to come back and respond to something label Oct 3, 2025
@microsoft-github-policy-service microsoft-github-policy-service bot added the No-Recent-Activity This issue/PR is going stale and may be auto-closed without further activity. label Oct 10, 2025
@AvishekDas5
Copy link
Contributor Author

Hi! Just checking in on this. I understand you're having an internal discussion about where this documentation should live (repository vs Microsoft Learn). I'm happy to make any adjustments needed based on your decision. Please let me know if there's anything specific you need from me in the meantime. Thanks!

@microsoft-github-policy-service microsoft-github-policy-service bot added Needs-Attention The core contributors need to come back around and look at this ASAP. and removed Needs-Author-Feedback The original author of the issue/PR needs to come back and respond to something No-Recent-Activity This issue/PR is going stale and may be auto-closed without further activity. labels Oct 10, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Area-Settings Issues related to settings and customizability, for console or terminal Issue-Docs It's a documentation issue that really should be on MicrosoftDocs/Console-Docs Needs-Attention The core contributors need to come back around and look at this ASAP. Product-Terminal The new Windows Terminal.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Documentation update: explain the color names and how they related to ECMA-48

2 participants