Skip to content

Add beginner code explanation sections to get-started.md#54102

Merged
BillWagner merged 3 commits into
dotnet:mainfrom
melgoharyme:melgoharyme/get-started-understand-code
Jun 1, 2026
Merged

Add beginner code explanation sections to get-started.md#54102
BillWagner merged 3 commits into
dotnet:mainfrom
melgoharyme:melgoharyme/get-started-understand-code

Conversation

@melgoharyme
Copy link
Copy Markdown
Contributor

@melgoharyme melgoharyme commented May 30, 2026

The Get Started with .NET tutorial shows how to create and run a simple file-based app, but it does not explain the code or what happens when the app is executed.

This PR adds two short sections to help beginners understand the example before moving on to more advanced tutorials.

Summary

In the Get started with .NET tutorial, add two sections:

  • A new section titled Understand the code that explains Console.WriteLine("Hello, World!"), including what Console and WriteLine are, what a string literal is, and what a statement is in C#.
  • An additional section titled How file-based apps work that explains what happens when you run dotnet hello-world.cs, why a project file is not required, and how file-based apps relate to project-based apps.

No change was made to any existing content.


Internal previews

📄 File 🔗 Preview link
docs/core/get-started.md Get started with .NET

Add two sections to the Get started with .NET tutorial:

- Add "Understand the code" section that breaks down
  Console.WriteLine("Hello, World!") into its parts.

- Add "How file-based apps work" section that explains
  what `dotnet hello-world.cs` do and why no project
  file is needed.

No existing content was modified.
@melgoharyme melgoharyme requested a review from a team as a code owner May 30, 2026 09:27
@dotnetrepoman dotnetrepoman Bot added this to the May 2026 milestone May 30, 2026
@dotnet-policy-service dotnet-policy-service Bot added dotnet-fundamentals/svc community-contribution Indicates PR is created by someone from the .NET community. labels May 30, 2026
Copy link
Copy Markdown
Member

@BillWagner BillWagner left a comment

Choose a reason for hiding this comment

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

Thanks @melgoharyme

This is a great addition. I'll :shipit: now.

@BillWagner BillWagner enabled auto-merge (squash) June 1, 2026 14:15
Comment thread docs/core/get-started.md Outdated
Co-authored-by: Bill Wagner <wiwagn@microsoft.com>
Comment thread docs/core/get-started.md
@BillWagner BillWagner merged commit 31be9d1 into dotnet:main Jun 1, 2026
9 checks passed
@melgoharyme melgoharyme deleted the melgoharyme/get-started-understand-code branch June 1, 2026 17:52
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

community-contribution Indicates PR is created by someone from the .NET community. dotnet-fundamentals/svc

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants