Updates

Author: madeline-underwood

content/learning-paths/servers-and-cloud-computing/dotnet-migration/3-any-cpu.md

@@ -1,5 +1,5 @@
 ---
-title: Run a .NET OrchardCore application on Arm and x86
+title: Configure and run an architecture-agnostic OrchardCore app on Arm and x86 using .NET AnyCPU
 weight: 4
 
 ### FIXED, DO NOT MODIFY
@@ -8,29 +8,35 @@ layout: learningpathall
 
 ## Run a .NET OrchardCore application on Arm and x86
 
-In this section, you will learn how to configure and run your OrchardCore application on both Arm and x86 architectures using the .NET AnyCPU configuration. This approach allows your application to be architecture-agnostic, enabling easier deployment across different hardware platforms.
+In this section, you will configure and run your OrchardCore application on both Arm and x86 architectures using .NET's AnyCPU configuration. This architecture-agnostic approach simplifies deployment and ensures that your application runs smoothly on diverse hardware, including cloud VMs, local development boxes, and edge devices.
 
-The AnyCPU feature has existed since .NET Framework 2.0, but its current behavior (particularly how it handles 32-bit vs. 64-bit execution) was defined in .NET Framework 4.5.
+The AnyCPU feature has existed since .NET Framework 2.0, but its current behavior (particularly how it handles 32-bit vs. 64-bit execution) was defined in .NET Framework 4.5. 
+
+{{% notice Note %}}
+In .NET Core and .NET 5+, AnyCPU still lets the runtime decide which architecture to use, but keep in mind that your build must match the runtime environment's bitness (32-bit vs. 64-bit). Since .NET 8 targets 64-bit by default, this Learning Path assumes 64-bit runtime environments on both Arm64 and x86_64.
+{{% /notice %}}
 
 ## Configure the project for AnyCPU
 
-To make your OrchardCore application architecture-agnostic, you need to configure it to use the AnyCPU platform target. This allows the .NET runtime to choose the appropriate architecture at runtime.
+To make your OrchardCore application architecture-agnostic, configure the project to use the AnyCPU platform target. This allows the .NET runtime to select the appropriate architecture at runtime.
 
-First, open your OrchardCore project `MyOrchardCoreApp.csproj` in your preferred IDE.
+1. Open your OrchardCore project `MyOrchardCoreApp.csproj` in your IDE.
 
-Next, find the `<PropertyGroup>` and add the `<PlatformTarget>` element to `AnyCPU`:
+2. Add the `<PlatformTarget>` element to your existing `<PropertyGroup>`:
 
 ```xml
 <PropertyGroup>
   <PlatformTarget>AnyCPU</PlatformTarget>
 </PropertyGroup>
 ```
 
-Save the `.csproj` file:
+3. Save the `.csproj` file.
+
+## Build and run on any platform
 
-## Build once, run anywhere
+You can now build your application once and run it on either an x86_64 or Arm64 system.
 
-You can now build your application on either an x86 or Arm host machine and deploy it on any architecture:
+Build the application:
 
 ```bash
 dotnet build -c Release
@@ -50,10 +56,10 @@ dotnet ./bin/Release/net8.0/MyOrchardCoreApp.dll --urls http://0.0.0.0:8080
 
 ## Benefits of architecture-agnostic applications
 
-By configuring your application to be architecture-agnostic, you gain several benefits:
+Using the AnyCPU configuration offers several advantages:
 
-- **Flexibility**: Deploy your application on a wide range of devices without modification.
-- **Efficiency**: Reduce the need for maintaining separate builds for different architectures.
+- **Flexibility**: Deploy your application on a wide range of devices without modifying your code.
+- **Efficiency**: Eliminate the need to maintain separate builds for different architectures.
 - **Scalability**: Easily scale your application across different hardware platforms.
 
-This approach ensures that your OrchardCore application can run seamlessly on both Arm and x86 architectures.
+This approach ensures that your OrchardCore application runs consistently on both Arm and x86 architectures.

content/learning-paths/servers-and-cloud-computing/dotnet-migration/_index.md

@@ -38,6 +38,10 @@ further_reading:
     - resource:
         title: OrchardCore documentation
         link: https://docs.orchardcore.net/
+        type: documentation  
+    - resource:
+        title: OrchardCore GitHub Repository
+        link: https://github.com/OrchardCMS/OrchardCore
         type: documentation
     - resource:
         title: .NET documentation