Update C# Hub and landing pages (#46497)

* Update landing pages

* fix build warnings

* Update hub pages

* more warnings.

* Apply suggestions from code review

Co-authored-by: Genevieve Warren <[email protected]>

---------

Co-authored-by: Genevieve Warren <[email protected]>

Author: BillWagner

docs/csharp/index.yml

@@ -208,6 +208,34 @@ additionalContent:
       summary: "You can choose web, mobile, desktop, gaming, IoT, and more." # < 160 chars (optional)
       items:
         # Card
+        - title: Machine learning and AI
+          links:
+            - url: ../machine-learning/index.yml
+              text: Build custom AI solutions with ML.NET
+            - url: /azure/cognitive-services/
+              text: Azure Cognitive Services
+            - url: /azure/machine-learning
+              text: Azure Machine Learning
+            - url: ../fsharp/scenarios/machine-learning.md
+              text: F# for machine learning
+        # Card
+        - title: Cloud
+          links:
+            - url: ../azure/index.yml
+              text: Azure for .NET developers
+            - url: /dotnet/aspire
+              text: .NET Aspire
+            - url: /dotnet/aspire/get-started/quickstart-build-your-first-aspire-app
+              text: Build cloud-native apps with .NET Aspire
+            - url: ../azure/migration/app-service.md?preserve-view=true&view=azure-dotnet
+              text: Migrate on-premises .NET web apps or services
+            - url: ../azure/key-azure-services.md
+              text: Azure services for .NET developers
+            - url: ../azure/sdk/azure-sdk-for-dotnet.md
+              text: Azure SDK for .NET
+            - url: ../fsharp/using-fsharp-on-azure/deploying-and-managing.md
+              text: Deploy Azure resources with F#
+        # Card
         - title: Web
           links:
             - url: /aspnet/core/tutorials
@@ -223,17 +251,6 @@ additionalContent:
             - url: ../fsharp/scenarios/web-development.md
               text: F# for web development
         # Card
-        - title: Mobile and Desktop
-          links:
-            - url: /dotnet/desktop/wpf/
-              text: Windows Presentation Foundation
-            - url: /dotnet/desktop/winforms/
-              text: Windows Forms
-            - url: /dotnet/maui
-              text: .NET Multi-platform App UI (.NET MAUI)
-            - url: /azure/developer/mobile-apps
-              text: Develop mobile apps with Azure
-        # Card
         - title: Microservices
           links:
             - url: ../architecture/dapr-for-net-developers/index.md
@@ -247,31 +264,24 @@ additionalContent:
             - url: ../core/extensions/cloud-service.md
               text: Deploy a Worker Service to Azure
         # Card
-        - title: Cloud
+        - title: Mobile, Desktop, and IoT
           links:
-            - url: ../azure/index.yml
-              text: Azure for .NET developers
-            - url: /dotnet/aspire
-              text: .NET Aspire
-            - url: ../azure/migration/app-service.md?preserve-view=true&view=azure-dotnet
-              text: Migrate on-premises .NET web apps or services
-            - url: ../azure/key-azure-services.md
-              text: Azure services for .NET developers
-            - url: ../azure/sdk/azure-sdk-for-dotnet.md
-              text: Azure SDK for .NET
-            - url: ../fsharp/using-fsharp-on-azure/deploying-and-managing.md
-              text: Deploy Azure resources with F#
-        # Card
-        - title: Machine learning and AI
-          links:
-            - url: ../machine-learning/index.yml
-              text: Build custom AI solutions with ML.NET
-            - url: /azure/cognitive-services/
-              text: Azure Cognitive Services
-            - url: /azure/machine-learning
-              text: Azure Machine Learning
-            - url: ../fsharp/scenarios/machine-learning.md
-              text: F# for machine learning
+            - url: /dotnet/desktop/wpf/
+              text: Windows Presentation Foundation
+            - url: /dotnet/desktop/winforms/
+              text: Windows Forms
+            - url: /dotnet/maui
+              text: .NET Multi-platform App UI (.NET MAUI)
+            - url: /azure/developer/mobile-apps
+              text: Develop mobile apps with Azure
+            - url: ../iot/index.yml
+              text: .NET IoT libraries
+            - url: ../iot/quickstarts/sensehat.md
+              text: Get started with IOT in 5 minutes
+            - url: ../iot/tutorials/blink-led.md
+              text: Blink an LED
+            - url: https://aka.ms/dotnet/beginnervideos/youtube/iot
+              text: .NET IoT 101 video series
         # Card
         - title: Game development
           links:
@@ -283,17 +293,6 @@ additionalContent:
               text: Build games with C# using the MonoGame library
             - url: https://docs.unity3d.com/Manual/index.html
               text: Learn how to use Unity to build 2D and 3D games with C#
-        # Card
-        - title: Internet of things (IoT)
-          links:
-            - url: ../iot/index.yml
-              text: .NET IoT libraries
-            - url: ../iot/quickstarts/sensehat.md
-              text: Get started in 5 minutes
-            - url: ../iot/tutorials/blink-led.md
-              text: Blink an LED
-            - url: https://aka.ms/dotnet/beginnervideos/youtube/iot
-              text: .NET IoT 101 video series
 
     - title: API and language reference # < 60 chars (optional)
       summary: Search the .NET API and language reference documentation. # < 160 chars (optional)
@@ -303,17 +302,21 @@ additionalContent:
           summary: API reference documentation for .NET
           url: ../../api/index.md
         # Card
-        - title: ".NET Framework API reference"
-          summary: API reference documentation for .NET Framework
-          url: ../../api/index.md?view=netframework-4.8&preserve-view=true
-        # Card
         - title: "ASP.NET Core API reference"
           summary: API reference documentation for ASP.NET Core
           url: ../../api/index.md
         # Card
+        - title: ".NET Aspire API reference"
+          summary: Reference documentation for .NET Aspire
+          url: ../../api/index.md?view=dotnet-aspire-9.0&preserve-view=true
+        # Card
         - title: "ML.NET API reference"
           summary: API reference documentation for ML.NET
           url: ../../api/index.md
+        # Card
+        - title: ".NET Framework API reference"
+          summary: API reference documentation for .NET Framework
+          url: ../../api/index.md?view=netframework-4.8&preserve-view=true
 
   # footer (Optional; Remove if not applicable.)
   footer: "Are you interested in contributing to the .NET docs? For more information, see our [contributor guide](/contribute/dotnet/dotnet-contribute)."

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

@@ -7,7 +7,7 @@ metadata:
   title: "C# docs - get started, tutorials, reference."
   description: "Learn C# programming - for beginning developers, developers new to C#, and experienced C# / .NET developers"
   ms.topic: landing-page # Required
-  ms.date: 05/08/2024
+  ms.date: 05/29/2025
 
 
 landingContent:
@@ -17,6 +17,8 @@ landingContent:
         links:
           - text: Learn C# | Tutorials, courses, videos, and more 
             url: https://dotnet.microsoft.com/learn/csharp
+          - text: Beginner C# tutorials in your browser
+            url: ./tutorials/index.md
       - linkListType: video
         links:
           - text: "C# beginner video series"
@@ -48,6 +50,8 @@ 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
+            url: ./strategy.md
       - linkListType: concept
         links:
           - text: "Type system"
@@ -105,7 +109,7 @@ landingContent:
       - linkListType: overview
         links:
           - text: C# language strategy
-            url: ../tour-of-csharp/strategy.md
+            url: ./strategy.md
           - text: "Programming concepts"
             url: ../programming-guide/concepts/index.md
       - linkListType: concept
@@ -114,6 +118,14 @@ landingContent:
             url: ../linq/index.md
           - text: "Asynchronous programming"
             url: ../programming-guide/concepts/async/index.md
+      - linkListType: learn
+        links:
+          - 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
 
   - title: "Advanced concepts"
     linkLists:
@@ -130,6 +142,30 @@ landingContent:
           - text: ".NET Compiler Platform SDK"
             url: ../roslyn-sdk/index.md
 
+  - title: "C# language reference"
+    linkLists:
+      - linkListType: reference
+        links:
+          - text: "Language reference"
+            url: ../language-reference/index.yml
+          - text: "Keywords"
+            url: ../language-reference/keywords/index.md
+          - text: "Operators and expressions"
+            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