Provide benefits for using alternatives#54000
Open
BillWagner wants to merge 3 commits into
Open
Conversation
Fixes dotnet#52871 I didn't add the explicit usings throughout the article. Instead, I added mores text to take the reader on a journey explaining the benefits of each of the alternatives. Finally, add a note that most of the samples in our docs assume the implicit usings are in place.
Contributor
There was a problem hiding this comment.
Pull request overview
Updates the C# “Namespaces and using directives” article to better explain tradeoffs among fully qualified names, file-level using directives, global usings, and implicit usings, and to clarify why many docs snippets omit explicit using statements.
Changes:
- Expanded narrative around readability benefits and repetition reduction for
usingdirectives and global usings. - Added additional context around implicit usings and how they affect what you see in code snippets.
- Adjusted guidance language around multi-namespace files.
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Fixes #52871
I didn't add the explicit usings throughout the article. Instead, I added mores text to take the reader on a journey explaining the benefits of each of the alternatives.
Finally, add a note that most of the samples in our docs assume the implicit usings are in place.
Internal previews