Modernize the Get Started content (#51565)

* Complete phase 1

* Finish step 3.

* Finish step 4

Phase 2 is now complete.

* Finish step 5.

* Content edit

* Continue to step 6.

* Finish step 7.

* copy edit

* Complete step 8

* copy edit.

* Finish step 9

* copy edit

* Step 10 for the plan.

* copy edit

* update tutorial

* Refresh first tutorial.

* refresh numbers tutorial

* copyedit

* Refresh this article.

* copy edit on tuples-and-types

* copy edit

* refresh this tutorial

* copy edit

* refresh patterns tutorials

* Finish the final tutorial

* Update links and checks

* fix warnings

* Add links to Aspire

* interim checkin.

* Apply suggestions from code review

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* General Copyedit.

* small nits

* Apply suggestion from @BillWagner

* Apply suggestions from code review

Co-authored-by: Meaghan Osagie (Lewis) <moneikmarie@gmail.com>

* global replace terms

Globally replace "file-based program" with "file-based app"

---------

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Meaghan Osagie (Lewis) <moneikmarie@gmail.com>

Author: 3 people

docs/csharp/fundamentals/tutorials/file-based-programs.md

@@ -14,7 +14,7 @@ In this tutorial, you:
 
 > [!div class="checklist"]
 >
-> * Create a file-based program.
+> * Create a file-based app.
 > * Add Unix shebang (`#!`) support.
 > * Read command line arguments.
 > * Handle standard input.
@@ -23,15 +23,15 @@ In this tutorial, you:
 > * Use parsed command line results.
 > * Test the final application.
 
-You build a file-based program that writes text as ASCII art. The app is contained in a single file, uses NuGet packages, and implements core features.
+You build a file-based app that writes text as ASCII art. The app is contained in a single file, uses NuGet packages, and implements core features.
 
 ## Prerequisites
 
 - The .NET 10 SDK. Download it from the [.NET download site](https://dotnet.microsoft.com/download/dotnet/10.0).
 - Visual Studio Code. Download it from the [Visual Studio Code homepage](https://code.visualstudio.com/Download).
 - (Optional) The C# DevKit extension for Visual Studio Code. Download it from the [Visual Studio Code marketplace](https://marketplace.visualstudio.com/items?itemName=ms-dotnettools.csdevkit).
 
-## Create a file-based program
+## Create a file-based app
 
 1. Open Visual Studio Code and create a new file named `AsciiArt.cs`. Enter the following text:
 
@@ -61,7 +61,7 @@ AsciiArt succeeded (7.3s) → Library/Application Support/dotnet/runfile/AsciiAr
 
 That output tells you where the temporary files and build outputs are placed. Throughout this tutorial, anytime you edit the source file, the `dotnet` host updates the executable before it runs.
 
-File-based apps are regular C# programs. The only limitation is that you must write them in one source file. You can use top-level statements or a classic `Main` method as an entry point. You can declare any types: classes, interfaces, and structs. You can structure the algorithms in a file-based program the same as you would in any C# program. You can even declare multiple namespaces to organize your code. If you find a file-based program is growing too large for a single file, you can convert it to a project-based program and split the source into multiple files. File-based apps are a great prototyping tool. You can start experimenting with minimal overhead to prove concepts and build algorithms.
+File-based apps are regular C# programs. The only limitation is that you must write them in one source file. You can use top-level statements or a classic `Main` method as an entry point. You can declare any types: classes, interfaces, and structs. You can structure the algorithms in a file-based app the same as you would in any C# program. You can even declare multiple namespaces to organize your code. If you find a file-based app is growing too large for a single file, you can convert it to a project-based program and split the source into multiple files. File-based apps are a great prototyping tool. You can start experimenting with minimal overhead to prove concepts and build algorithms.
 
 ## Unix shebang (`#!`) support
 
@@ -169,7 +169,7 @@ Now your program can accept either command line arguments or standard input.
 
 ## Write ASCII art output
 
-Next, add a package that supports ASCII art, [Colorful.Console](https://www.nuget.org/packages/Colorful.Console). To add a package to a file-based program, use the `#:package` directive.
+Next, add a package that supports ASCII art, [Colorful.Console](https://www.nuget.org/packages/Colorful.Console). To add a package to a file-based app, use the `#:package` directive.
 
 1. Add the following directive after the `#!` directive in your `AsciiArt.cs` file:
 
@@ -268,7 +268,7 @@ Test the application by running several different commands. If you have trouble,
 
 :::code language="csharp" source="./snippets/file-based-programs/AsciiArt":::
 
-In this tutorial, you learned to build a file-based program, where you build the program in a single C# file. These programs don't use a project file, and can use the `#!` directive on Unix systems. Learners can create these programs after trying our [online tutorials](../../tour-of-csharp/tutorials/hello-world.md) and before building larger project-based apps. File-based apps are also a great platform for command line utilities.
+In this tutorial, you learned to build a file-based app, where you build the program in a single C# file. These programs don't use a project file, and can use the `#!` directive on Unix systems. Learners can create these programs after trying our [online tutorials](../../tour-of-csharp/tutorials/hello-world.md) and before building larger project-based apps. File-based apps are also a great platform for command line utilities.
 
 ## Related content
 

docs/csharp/fundamentals/tutorials/snippets/file-based-programs/AsciiArt

@@ -17,7 +17,7 @@ Argument<string[]> messagesArgument = new("Messages")
     Description = "Text to render."
 };
 
-RootCommand rootCommand = new("Ascii Art file-based program sample");
+RootCommand rootCommand = new("Ascii Art file-based app sample");
 
 rootCommand.Options.Add(delayOption);
 rootCommand.Arguments.Add(messagesArgument);

docs/csharp/fundamentals/tutorials/snippets/file-based-programs/AsciiArt.cs

@@ -26,7 +26,7 @@
 // </OptionArgument>
 
 // <RootCommand>
-RootCommand rootCommand = new("Ascii Art file-based program sample");
+RootCommand rootCommand = new("Ascii Art file-based app sample");
 
 rootCommand.Options.Add(delayOption);
 rootCommand.Arguments.Add(messagesArgument);

docs/csharp/index.yml

@@ -14,7 +14,7 @@ metadata:
   ms.topic: hub-page
   author: billwagner
   ms.author: wiwagn
-  ms.date: 05/30/2025
+  ms.date: 02/06/2026
 
 # highlightedContent section (Optional; Remove if not applicable.)
 # Maximum of 8 items
@@ -59,12 +59,12 @@ productDirectory:
       links:
         - url: ./tour-of-csharp/overview.md
           text: A tour of C#
+        - url: ./tour-of-csharp/what-you-can-build.md
+          text: What you can build with C#
         - url: ./tour-of-csharp/tutorials/index.md
           text: Beginner C# tutorials
-        - url: ./tour-of-csharp/tutorials/hello-world.md
-          text: Try C# in your browser
-        - url: ./fundamentals/program-structure/index.md
-          text: "Inside a C# program"
+        - url: ./tour-of-csharp/tips-for-java-developers.md
+          text: "C# for Java developers"
         - url: https://aka.ms/dotnet/beginnervideos/learn/csharp
           text: "C# for beginners video series"
         - url: https://aka.ms/csharp-certification

docs/csharp/language-reference/compiler-messages/preprocessor-errors.md

@@ -112,9 +112,9 @@ The compiler generates the following errors for incorrect use of preprocessor di
 - [**CS8996**](#invalid-preprocessor-directive-syntax): *Raw string literals are not allowed in preprocessor directives*
 - [**CS9028**](#line-and-file-directive-errors): *The #line span directive requires space before the first parenthesis, before the character offset, and before the file name*
 - [**CS9297**](#incorrect-use-of-file-based-apps-directives): *`#:` directives cannot be after first token in file*
-- [**CS9298**](#incorrect-use-of-file-based-apps-directives): *`#:` directives can be only used in file-based programs (`-features:FileBasedProgram`)*
+- [**CS9298**](#incorrect-use-of-file-based-apps-directives): *`#:` directives can be only used in file-based apps (`-features:FileBasedProgram`)*
 - [**CS9299**](#incorrect-use-of-file-based-apps-directives): *`#:` directives cannot be after `#if` directive*
-- [**CS9314**](#incorrect-use-of-file-based-apps-directives): *`#!` directives can be only used in scripts or file-based programs*
+- [**CS9314**](#incorrect-use-of-file-based-apps-directives): *`#!` directives can be only used in scripts or file-based apps*
 
 ## Invalid preprocessor directive syntax
 
@@ -424,9 +424,9 @@ To fix these errors, ensure your `#line` directives and file-related preprocesso
 ## Incorrect use of file-based apps directives
 
 - **CS9297**: *`#:` directives cannot be after first token in file*
-- **CS9298**: *`#:` directives can be only used in file-based programs (`-features:FileBasedProgram`)*
+- **CS9298**: *`#:` directives can be only used in file-based apps (`-features:FileBasedProgram`)*
 - **CS9299**: *`#:` directives cannot be after `#if` directive*
-- **CS9314**: *`#!` directives can be only used in scripts or file-based programs*
+- **CS9314**: *`#!` directives can be only used in scripts or file-based apps*
 
 These errors indicate that you used the `#:` directives for a file-based app incorrectly. You can learn more about the syntax for these directives in the article on [preprocessor directives](../preprocessor-directives.md#file-based-apps) in the section on file-based apps. Or, you can explore file based apps by following the [tutorial](../../fundamentals/tutorials/file-based-programs.md) on file-based apps.
 

docs/csharp/toc.yml

@@ -5,6 +5,8 @@ items:
   items:
   - name: Tour of C#
     href: tour-of-csharp/overview.md
+  - name: What you can build
+    href: tour-of-csharp/what-you-can-build.md
   - name: Tutorials
     items:
     - name: Choose your first lesson

docs/csharp/tour-of-csharp/index.yml

@@ -1,44 +1,42 @@
 ### YamlMime:Landing
 
 title: "C# documentation"
-summary: "Learn how to write any application using the C# programming language on the .NET platform."
+summary: "Learn how to write any application using the C# programming language."
 
 metadata:
   title: "C# docs - get started, tutorials, reference."
-  description: "Learn C# programming - for beginning developers, developers new to C#, and experienced C# / .NET developers"
+  description: "Learn C# programming - for beginning developers, developers new to C#, and experienced C# developers"
   ms.topic: landing-page # Required
-  ms.date: 05/29/2025
+  ms.date: 02/06/2026
 
 
 landingContent:
-  - title: "Learn to program"
+  - title: "Choose your path"
     linkLists:
       - linkListType: get-started
         links:
-          - text: Learn C# | Tutorials, courses, videos, and more 
-            url: https://dotnet.microsoft.com/learn/csharp
-          - text: Beginner C# tutorials in your browser
+          - text: "New to programming? Start with beginner tutorials"
             url: ./tutorials/index.md
-      - linkListType: video
-        links:
+          - text: "In-browser tutorial: Hello world"
+            url: ./tutorials/hello-world.md
           - text: "C# beginner video series"
             url: https://aka.ms/dotnet/beginnervideos/youtube/csharp
-      - linkListType: tutorial
+      - linkListType: overview
         links:
-          - text: "Self-guided tutorials"
-            url: https://learn.microsoft.com/users/dotnet/collections/yz26f8y64n7k07?WT.mc_id=dotnet-35129-website 
-          - text: "In-browser tutorial"
-            url: ./tutorials/hello-world.md
-      - linkListType: reference
+          - text: "Experienced developer? A tour of C#"
+            url: ./overview.md
+          - text: Learn C# for Java developers
+            url: ./tips-for-java-developers.md
+          - text: Learn C# for JavaScript developers
+            url: ./tips-for-javascript-developers.md
+          - text: Learn C# for Python developers
+            url: ./tips-for-python-developers.md
+      - linkListType: learn
         links:
-          - text: "C# on Q&A"
-            url: /answers/topics/dotnet-csharp.html
-          - text: "Languages on .NET tech community forums"
-            url: https://techcommunity.microsoft.com/t5/languages/bd-p/languages
-          - text: "C# on Stack Overflow"
-            url: https://stackoverflow.com/questions/tagged/c%23
-          - text: "C# on Discord"
-            url: https://aka.ms/csharp-discord
+          - text: Foundational C# Certification
+            url: https://aka.ms/csharp-certification
+          - text: What you can build with C#
+            url: ./what-you-can-build.md
 
   - title: "Fundamentals"
     linkLists:
@@ -50,7 +48,7 @@ landingContent:
             url: ../fundamentals/program-structure/index.md
           - text: "C# highlights video series"
             url: https://youtube.com/playlist?list=PLdo4fOcmZ0oU3ZLx6Ul1_HPrr6lFPIn9O
-          - text: C# Language development strategy
+          - text: C# language strategy
             url: ./strategy.md
       - linkListType: concept
         links:
@@ -66,8 +64,8 @@ landingContent:
             url: ../fundamentals/coding-style/identifier-names.md
       - linkListType: tutorial
         links:
-          - text: Display command-line
-            url: ../fundamentals/tutorials/how-to-display-command-line-arguments.md
+          - text: Build file-based apps
+            url: ../fundamentals/tutorials/file-based-programs.md
           - text: Intro to classes
             url: ../fundamentals/tutorials/classes.md
           - text: Object oriented C#
@@ -106,6 +104,8 @@ landingContent:
     linkLists:
       - linkListType: overview
         links:
+          - text: What you can build with C#
+            url: ./what-you-can-build.md
           - text: C# language strategy
             url: ./strategy.md
           - text: "Programming concepts"
@@ -125,21 +125,6 @@ landingContent:
           - text: Learn C# for Python developers
             url: ./tips-for-python-developers.md
 
-  - title: "Advanced concepts"
-    linkLists:
-      - linkListType: reference
-        links:
-          - text: "Reflection and attributes"
-            url: ../advanced-topics/reflection-and-attributes/index.md
-          - text: "Expression trees"
-            url: ../advanced-topics/expression-trees/index.md
-          - text: "Native interoperability"
-            url: ../advanced-topics/interop/index.md
-          - text: "Performance engineering"
-            url: ../advanced-topics/performance/index.md
-          - text: ".NET Compiler Platform SDK"
-            url: ../roslyn-sdk/index.md
-
   - title: "C# language reference"
     linkLists:
       - linkListType: reference
@@ -152,25 +137,18 @@ landingContent:
             url: ../language-reference/operators/index.md
           - text: "Tokens"
             url: ../language-reference/tokens/index.md
-  
-  - title: "C# language standard"
-    linkLists:
-      - linkListType: reference
-        links:
-          - text: "Overview"
-            url: ../specification/overview.md
-          - text: "C# language specification"
-            url: ../../../_csharpstandard/standard/README.md
-          - text: "Feature specifications"
-            url: ../specification/feature-spec-overview.md
 
   - title: "Stay in touch"
     linkLists:
       - linkListType: reference
         links:
+          - text: "C# on Q&A"
+            url: /answers/topics/dotnet-csharp.html
           - text: ".NET developer community"
             url: https://dotnet.microsoft.com/platform/community
+          - text: "C# on Stack Overflow"
+            url: https://stackoverflow.com/questions/tagged/c%23
+          - text: "C# on Discord"
+            url: https://aka.ms/csharp-discord
           - text: "YouTube"
             url: https://www.youtube.com/dotnet
-          - text: "Twitter"
-            url: https://twitter.com/DotNet