Update GetStarted TOC and curate tutorials (#45144)

* Convert first tutorial to try.net snippets

Move the TOC nodes, convert the initial tutorial to a snippet style.

* Add note on using the interactive window.

* Consolidate the Numbers tutorial

Combine the online and local tutorials for numbers.

* Consolidate the Branches tutorial

Combine the online and local tutorials for branches and loops.

* warnings

* Consolidate the last intro tutorial

Consolidate the list collections tutorial into one online version.

* Edit and update the index

* fix warnings

Author: BillWagner

.openpublishing.redirection.csharp.json

@@ -4156,6 +4156,22 @@
             "source_path_from_root": "/docs/csharp/tour-of-csharp/types.md",
             "redirect_url": "/dotnet/csharp/tour-of-csharp"
         },
+        {
+            "source_path_from_root": "/docs/csharp/tour-of-csharp/tutorials/arrays-and-collections.md",
+            "redirect_url": "/dotnet/csharp/tour-of-csharp/tutorials/list-collection"
+        },
+        {
+            "source_path_from_root": "/docs/csharp/tour-of-csharp/tutorials/local-environment.md",
+            "redirect_url": "/dotnet/csharp/tour-of-csharp/tutorials"
+        },
+        {
+            "source_path_from_root": "/docs/csharp/tour-of-csharp/tutorials/branches-and-loops-local.md",
+            "redirect_url": "/dotnet/csharp/tour-of-csharp/tutorials/branches-and-loops"
+        },
+        {
+            "source_path_from_root": "/docs/csharp/tour-of-csharp/tutorials/numbers-in-csharp-local.md",
+            "redirect_url": "/dotnet/csharp/tour-of-csharp/tutorials/numbers-in-csharp"
+        },
         {
             "source_path_from_root": "/docs/csharp/tuples.md",
             "redirect_url": "/dotnet/csharp/language-reference/builtin-types/value-tuples"

docs/core/introduction.md

@@ -83,6 +83,6 @@ There are multiple variants of .NET, each supporting a different type of app. Th
 ## Next steps
 
 * [Choose a .NET tutorial](tutorials/index.md)
-* [Try .NET in your browser](../csharp/tour-of-csharp/tutorials/numbers-in-csharp.yml)
+* [Try .NET in your browser](../csharp/tour-of-csharp/tutorials/numbers-in-csharp.md)
 * [Take a tour of C#](../csharp/tour-of-csharp/overview.md)
 * [Take a tour of F#](../fsharp/tour.md)

docs/csharp/index.yml

@@ -61,7 +61,7 @@ productDirectory:
           text: A tour of C#
         - url: ./tour-of-csharp/tutorials/index.md
           text: Beginner C# tutorials
-        - url: ./tour-of-csharp/tutorials/hello-world.yml
+        - 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"

docs/csharp/toc.yml

@@ -5,38 +5,28 @@ items:
   items:
   - name: Tour of C#
     href: tour-of-csharp/overview.md
-  - name: Learn C# for Java developers
-    href: tour-of-csharp/tips-for-java-developers.md
-  - name: Learn C# for JavaScript developers
-    href: tour-of-csharp/tips-for-javascript-developers.md
-  - name: Learn C# for Python developers
-    href: tour-of-csharp/tips-for-python-developers.md
-  - name: C# language strategy
-    href: tour-of-csharp/strategy.md
   - name: Tutorials
     items:
     - name: Choose your first lesson
       href: tour-of-csharp/tutorials/index.md
-    - name: Browser based tutorials
-      items:
-      - name: Hello world
-        href: tour-of-csharp/tutorials/hello-world.yml
-      - name: Numbers in C#
-        href: tour-of-csharp/tutorials/numbers-in-csharp.yml
-      - name: Branches and loops
-        href: tour-of-csharp/tutorials/branches-and-loops.yml
-      - name: List collections
-        href: tour-of-csharp/tutorials/list-collection.yml
-    - name: Work in your local environment
+    - name: Tutorials
       items:
-      - name: Set up your environment
-        href: tour-of-csharp/tutorials/local-environment.md
+      - name: Hello world and text
+        href: tour-of-csharp/tutorials/hello-world.md
       - name: Numbers in C#
-        href: tour-of-csharp/tutorials/numbers-in-csharp-local.md
+        href: tour-of-csharp/tutorials/numbers-in-csharp.md
       - name: Branches and loops
-        href: tour-of-csharp/tutorials/branches-and-loops-local.md
+        href: tour-of-csharp/tutorials/branches-and-loops.md
       - name: List collections
-        href: tour-of-csharp/tutorials/arrays-and-collections.md
+        href: tour-of-csharp/tutorials/list-collection.md
+  - name: C# language strategy
+    href: tour-of-csharp/strategy.md
+  - name: Learn C# for Java developers
+    href: tour-of-csharp/tips-for-java-developers.md
+  - name: Learn C# for JavaScript developers
+    href: tour-of-csharp/tips-for-javascript-developers.md
+  - name: Learn C# for Python developers
+    href: tour-of-csharp/tips-for-python-developers.md
 - name: Fundamentals
   items:
   - name: Program structure

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

@@ -26,7 +26,7 @@ landingContent:
           - 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.yml
+            url: ./tutorials/hello-world.md
       - linkListType: reference
         links:
           - text: "C# on Q&A"

docs/csharp/tour-of-csharp/tips-for-python-developers.md

@@ -17,7 +17,7 @@ C# and Python share similar concepts. These familiar constructs help you learn C
 
 As you start learning C#, you'll learn these important concepts where C# is different than Python:
 
-1. [***Indentation vs. tokens***](./tutorials/branches-and-loops-local.md): In Python, newlines and indentation are first-class syntactic elements. In C#, whitespace isn't significant. Tokens, like `;` separate statements, and other tokens `{` and `}` control block scope for `if` and other block statements. However, for readability, most coding styles (including the style used in these docs) use indentation to reinforce the block scopes declared by `{` and `}`.
+1. [***Indentation vs. tokens***](./tutorials/branches-and-loops.md): In Python, newlines and indentation are first-class syntactic elements. In C#, whitespace isn't significant. Tokens, like `;` separate statements, and other tokens `{` and `}` control block scope for `if` and other block statements. However, for readability, most coding styles (including the style used in these docs) use indentation to reinforce the block scopes declared by `{` and `}`.
 1. [***Static typing***](../fundamentals/types/index.md): In C#, a variable declaration includes its type. Reassigning a variable to an object of a different type generates a compiler error. In Python, the type can change when reassigned.
 1. [***Nullable types***](../nullable-references.md): C# variables can be *nullable* or *non-nullable*. A non-nullable type is one that can't be null (or nothing). It always refers to a valid object. By contrast, a nullable type might either refer to a valid object, or null.
 1. [***LINQ***](../linq/index.md): The query expression keywords that make up Language Integrated Query (LINQ) aren't keywords in Python. However, Python libraries like `itertools`, `more-itertools`, and `py-linq` provide similar functionality.