Convert get-started tutorial to file-based app

[Copilot]

Updates the .NET getting started tutorial to use file-based app approach instead of dotnet new console, aligning with modern .NET tutorial patterns and the C# tour structure.

Changes

• Tutorial structure: Added Prerequisites, Open Codespaces, and Cleanup resources sections following C# tour hello-world template
• Prerequisites: GitHub Codespaces or local setup (.NET 10 SDK, VS Code, C# Dev Kit)
• Instructions: Changed from scaffolding (dotnet new console -o sample1) to creating single hello-world.cs file
• Command: Updated to dotnet run hello-world.cs for direct file execution
• Code snippet: Created /docs/core/snippets/get-started/csharp/hello-world.cs with region markers

Example

Before:

dotnet new console -o sample1
cd sample1
dotnet run

After:

// hello-world.cs
Console.WriteLine("Hello, World!");

dotnet run hello-world.cs

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

• learn.microsoft.com
  • Triggering command: /home/REDACTED/work/_temp/ghcca-node/node/bin/node /home/REDACTED/work/_temp/ghcca-node/node/bin/node --enable-source-maps /home/REDACTED/work/_temp/copilot-developer-action-main/dist/index.js (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

• Configure Actions setup steps to set up my environment, which run before the firewall is enabled
• Add the appropriate URLs or hosts to the custom allowlist in this repository's Copilot coding agent settings (admins only)

Original prompt

---

This section details on the original issue you should resolve

<issue_title>Convert Hello World tutorial to file-based app</issue_title>
<issue_description>### Type of issue

Other (describe below)

Description

Update Get started with .NET to a file-based app.

• Prerequisites: GitHub Codespaces or computer with: .NET 10, VS Code, C# Dev Kit
• Use the tutorial codespace
• Create a new file named hello-world.cs, open the file, add a line to write "Hello, World!" to the console. Then run your program.

Page URL

https://learn.microsoft.com/en-us/dotnet/core/get-started

Content source URL

https://github.com/dotnet/docs/blob/main/docs/core/get-started.md

Document Version Independent Id

fdb655a4-cff4-6c67-7244-673760379663

Platform Id

a1e002b7-8b60-1d38-46fc-7b3bf8978aa0

Article author

@adegeo

Metadata

• ID: 1c922021-b12a-83e4-3ee6-eceecd6076d2
• PlatformId: a1e002b7-8b60-1d38-46fc-7b3bf8978aa0
• Service: dotnet-fundamentals

Related Issues

---

Associated WorkItem - 543727</issue_description>

<agent_instructions>Follow the style of the tutorial here: https://learn.microsoft.com/en-us/dotnet/csharp/tour-of-csharp/tutorials/hello-world and include the same sections for: Prerequisites, and Open Codespaces</agent_instructions>

Comments on the Issue (you are @copilot in this section)

• Fixes Convert Hello World tutorial to file-based app #50707

---

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

---

Internal previews

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

[Copilot]

Pull request overview

This pull request updates the .NET getting started tutorial to use a file-based app approach instead of the traditional project scaffolding method. The changes align with modern .NET tutorial patterns and follow the structure of the C# tour hello-world template.

Changes:

• Added Prerequisites, Open Codespaces, and Cleanup resources sections following the C# tour template structure
• Converted tutorial from dotnet new console scaffolding to creating a single hello-world.cs file
• Updated execution command to dotnet run hello-world.cs for direct file-based app execution
• Created new code snippet files with region markers for documentation reference

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 2 comments.

File	Description
docs/core/get-started.md	Restructured tutorial to use file-based app approach with Prerequisites, Codespaces setup, and resource cleanup sections
docs/core/snippets/get-started/hello-world.cs	Added simple Hello World code snippet with region markers for documentation
docs/core/snippets/get-started/get-started.csproj	Added project file targeting .NET 10 with modern C# features enabled

[adegeo]

I'm not sure what we're trying to accomplish by promoting codespaces. I would think beginners have two paths:

• I want to install the dev environment on my computer and make an app.
• I want to go and quickly explore the C# language so I'll use a codespace.

What's our goal for new users? Get .NET local and create an app?

What about leading with installing things but telling them they can use codespaces if they don't want to install anything.

[meaghanlewis]

@adegeo thanks for your feedback. My plan for beginner .NET paths is to lead with using Codespaces first, and then an option to install all the things second. This is in line with the changes @BillWagner recently made with the C# getting started tutorials and promotes file-based apps as well.

I'm not sure what we're trying to accomplish by promoting codespaces. I would think beginners have two paths:

• I want to install the dev environment on my computer and make an app.
• I want to go and quickly explore the C# language so I'll use a codespace.

What's our goal for new users? Get .NET local and create an app?

What about leading with installing things but telling them they can use codespaces if they don't want to install anything.

[adegeo]

Approved to unblock. Let's put the code in a csharp folder :)