Skip to content

Standardize references to the UTF-8 term in code and comments/documentation#62074

Merged
AlekseyTs merged 6 commits intodotnet:mainfrom
AlekseyTs:Issue61846_61847
Jun 27, 2022
Merged

Standardize references to the UTF-8 term in code and comments/documentation#62074
AlekseyTs merged 6 commits intodotnet:mainfrom
AlekseyTs:Issue61846_61847

Conversation

@AlekseyTs
Copy link
Copy Markdown
Contributor

From a framework naming perspective, “Utf8” is preferred, because it’s a 3 letter abbreviation (for Unicode Transformation Format), and 3+ letter abbreviations should be PascalCased, like Html and Uri.

From a documentation/conceptual perspective, the preferred spelling of the Unicode Consortium seems to be “UTF-8” (all caps, with a hyphen).

Closes #61847.

Also fixes a typo and closes #61846.

From a framework naming perspective, “Utf8” is preferred, because it’s a 3 letter abbreviation (for Unicode Transformation Format), and 3+ letter abbreviations should be PascalCased, like Html and Uri.

From a documentation/conceptual perspective, the preferred spelling of the Unicode Consortium seems to be “UTF-8” (all caps, with a hyphen).

Closes dotnet#61847.
Copy link
Copy Markdown
Member

@jcouv jcouv left a comment

Choose a reason for hiding this comment

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

LGTM Thanks, both compiler and IDE changes looked at (iteration 5)

@jcouv jcouv self-assigned this Jun 22, 2022
@AlekseyTs
Copy link
Copy Markdown
Contributor Author

@dotnet/roslyn-compiler For the second review.

@AlekseyTs
Copy link
Copy Markdown
Contributor Author

@davidwengier For review of IDE side

Copy link
Copy Markdown
Member

@davidwengier davidwengier left a comment

Choose a reason for hiding this comment

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

IDE looks good

@AlekseyTs
Copy link
Copy Markdown
Contributor Author

@cston, @RikkiGibson, @dotnet/roslyn-compiler For the second review.

@AlekseyTs
Copy link
Copy Markdown
Contributor Author

@davidwengier Please take a look at IDE side of changes.

@AlekseyTs
Copy link
Copy Markdown
Contributor Author

@davidwengier Sorry, missed your sign-off, please disregard previous message.

EncodingUTF8,
EncodingUTF8_BOM,
EncodingUtf8,
EncodingUtf8_BOM,
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

It looks like these should be kept as-is, or "EncodingUTF32*" should be updated as well.

@AlekseyTs AlekseyTs enabled auto-merge (squash) June 24, 2022 11:54
@AlekseyTs AlekseyTs disabled auto-merge June 27, 2022 16:22
@AlekseyTs AlekseyTs merged commit eb7b204 into dotnet:main Jun 27, 2022
@ghost ghost added this to the Next milestone Jun 27, 2022
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

New public APIs for UTF8 String Literals New public APIs for Checked User-defined Operators

5 participants