Suggestion: Make using System; explicit in the "Using directives" example

[chathnindu]

Type of issue

Typo

Description

Hi team!

I was reading through the "Using directives" section and looking at the second code block (the ShowShortName method).

I noticed the comment mentions With 'using System;', but the actual using System; statement isn't shown in the code snippet itself. While I understand this might be relying on implicit usings or assuming the statement is at the top of the file, it can be a bit confusing for beginners who are just trying to understand the exact syntax.

Would it be possible to explicitly include using System; at the top of that specific code block? I think it would make the example crystal clear at a quick glance.

Thanks for the great documentation!

Page URL

https://learn.microsoft.com/en-us/dotnet/csharp/fundamentals/program-structure/namespaces

Content source URL

https://github.com/dotnet/docs/blob/main/docs/csharp/fundamentals/program-structure/namespaces.md

Document Version Independent Id

618f8082-b4e0-5561-fcf2-0dd814a5d710

Platform Id

3ac65e57-741d-e2e6-0e3a-1ebea79d2276

Article author

@BillWagner

Metadata

• ID: 5841309e-474a-716d-4e39-d7d8160fb3b1
• PlatformId: 3ac65e57-741d-e2e6-0e3a-1ebea79d2276
• Service: dotnet-csharp
• Sub-service: fundamentals

Related Issues

[BillWagner]

Hi @chathnindu

I see your point. Because these are fundamentals, and the new templates all have the required global using directives added as implicit usings, I'd like to keep the redundant usings out of the examples.

What do you think about updating the order of the article to discussing using directives first, then namespaces?

[chathnindu]

Hi @BillWagner ,
Thanks for the explanation! That makes perfect sense regarding the new templates and keeping the examples clean.

I think updating the order to discuss using directives first is a great idea. It solves the confusion for beginners without adding redundant code to the examples. Sounds good to me!

[BillWagner]

Thanks @chathnindu

I've added this to our next sprint, but if you want to submit a PR before then, I'll watch for it and merge it.