Merge pull request #51261 from lootle1/MR125

Stacyrch140 · web-flow · commit e1b281cfdc55 · 2025-07-15T11:00:43.000-04:00
Technical Review 1058678: Decompose a monolithic application into a m…
diff --git a/learn-pr/azure/microservices-architecture/1-introduction.yml b/learn-pr/azure/microservices-architecture/1-introduction.yml
@@ -1,14 +1,14 @@
-### YamlMime:ModuleUnit
-uid: learn.microservices-architecture.1-introduction
-metadata:
-  title: Introduction
-  description: Introduction
-  ms.date: 02/02/2024
-  author: rmcmurray
-  ms.author: robmcm
-  ms.topic: unit
-title: Introduction
-durationInMinutes: 5
-content: |
-  [!include[](includes/1-introduction.md)]
-
+### YamlMime:ModuleUnit
+uid: learn.microservices-architecture.1-introduction
+metadata:
+  title: Introduction
+  description: Introduction
+  ms.date: 07/08/2025
+  author: rmcmurray
+  ms.author: robmcm
+  ms.topic: unit
+title: Introduction
+durationInMinutes: 5
+content: |
+  [!include[](includes/1-introduction.md)]
+
diff --git a/learn-pr/azure/microservices-architecture/2-monolith-microservices.yml b/learn-pr/azure/microservices-architecture/2-monolith-microservices.yml
@@ -1,14 +1,14 @@
-### YamlMime:ModuleUnit
-uid: learn.microservices-architecture.2-monolith-microservices
-metadata:
-  title: Monolithic and microservice architectures
-  description: Monolithic and microservice architectures
-  ms.date: 02/02/2024
-  author: rmcmurray
-  ms.author: robmcm
-  ms.topic: unit
-title: Monolithic and microservice architectures
-durationInMinutes: 10
-content: |
-  [!include[](includes/2-monolith-microservices.md)]
-
+### YamlMime:ModuleUnit
+uid: learn.microservices-architecture.2-monolith-microservices
+metadata:
+  title: Monolithic and microservice architectures
+  description: Monolithic and microservice architectures
+  ms.date: 07/08/2025
+  author: rmcmurray
+  ms.author: robmcm
+  ms.topic: unit
+title: Monolithic and microservice architectures
+durationInMinutes: 10
+content: |
+  [!include[](includes/2-monolith-microservices.md)]
+
diff --git a/learn-pr/azure/microservices-architecture/3-exercise-deploy-monolithic-app.yml b/learn-pr/azure/microservices-architecture/3-exercise-deploy-monolithic-app.yml
@@ -1,16 +1,16 @@
-### YamlMime:ModuleUnit
-uid: learn.microservices-architecture.3-exercise-deploy-monolithic-app
-metadata:
-  title: Exercise - Deploy a monolithic application on App Service
-  description: Exercise - Deploy a monolithic application on App Service
-  ms.date: 02/02/2024
-  author: rmcmurray
-  ms.author: robmcm
-  ms.topic: unit
-title: Exercise - Deploy a monolithic application on App Service
-durationInMinutes: 10
-interactive: bash
-azureSandbox: true
-content: |
-  [!include[](includes/3-exercise-deploy-monolithic-app.md)]
-
+### YamlMime:ModuleUnit
+uid: learn.microservices-architecture.3-exercise-deploy-monolithic-app
+metadata:
+  title: Exercise - Deploy a monolithic application on App Service
+  description: Exercise - Deploy a monolithic application on App Service
+  ms.date: 07/08/2025
+  author: rmcmurray
+  ms.author: robmcm
+  ms.topic: unit
+title: Exercise - Deploy a monolithic application on App Service
+durationInMinutes: 10
+interactive: bash
+azureSandbox: true
+content: |
+  [!include[](includes/3-exercise-deploy-monolithic-app.md)]
+
diff --git a/learn-pr/azure/microservices-architecture/4-monolith-performance.yml b/learn-pr/azure/microservices-architecture/4-monolith-performance.yml
@@ -1,14 +1,14 @@
-### YamlMime:ModuleUnit
-uid: learn.microservices-architecture.4-monolith-performance
-metadata:
-  title: Performance constraints of a monolithic application
-  description: Performance constraints of a monolithic application
-  ms.date: 02/02/2024
-  author: rmcmurray
-  ms.author: robmcm
-  ms.topic: unit
-title: Performance constraints of a monolithic application
-durationInMinutes: 5
-content: |
-  [!include[](includes/4-monolith-performance.md)]
-
+### YamlMime:ModuleUnit
+uid: learn.microservices-architecture.4-monolith-performance
+metadata:
+  title: Performance constraints of a monolithic application
+  description: Performance constraints of a monolithic application
+  ms.date: 07/08/2025
+  author: rmcmurray
+  ms.author: robmcm
+  ms.topic: unit
+title: Performance constraints of a monolithic application
+durationInMinutes: 5
+content: |
+  [!include[](includes/4-monolith-performance.md)]
+
diff --git a/learn-pr/azure/microservices-architecture/5-analyze-decompose.yml b/learn-pr/azure/microservices-architecture/5-analyze-decompose.yml
@@ -1,14 +1,14 @@
-### YamlMime:ModuleUnit
-uid: learn.microservices-architecture.5-analyze-decompose
-metadata:
-  title: Analyze an application and identify decomposition boundaries
-  description: Analyze an application and identify decomposition boundaries
-  ms.date: 02/02/2024
-  author: rmcmurray
-  ms.author: robmcm
-  ms.topic: unit
-title: Analyze an application and identify decomposition boundaries
-durationInMinutes: 10
-content: |
-  [!include[](includes/5-analyze-decompose.md)]
-
+### YamlMime:ModuleUnit
+uid: learn.microservices-architecture.5-analyze-decompose
+metadata:
+  title: Analyze an application and identify decomposition boundaries
+  description: Analyze an application and identify decomposition boundaries
+  ms.date: 07/08/2025
+  author: rmcmurray
+  ms.author: robmcm
+  ms.topic: unit
+title: Analyze an application and identify decomposition boundaries
+durationInMinutes: 10
+content: |
+  [!include[](includes/5-analyze-decompose.md)]
+
diff --git a/learn-pr/azure/microservices-architecture/6-exercise-refactor-microservice.yml b/learn-pr/azure/microservices-architecture/6-exercise-refactor-microservice.yml
@@ -1,18 +1,18 @@
-### YamlMime:ModuleUnit
-uid: learn.microservices-architecture.6-exercise-refactor-microservice
-metadata:
-  title: Exercise - Refactor a service within the monolith as a microservice
-  description: Exercise - Refactor a service within the monolith as a microservice
-  ms.date: 02/02/2024
-  author: rmcmurray
-  ms.author: robmcm
-  ms.topic: unit
-  ms.custom:
-    - devx-track-azurecli
-title: Exercise - Refactor a service within the monolith as a microservice
-durationInMinutes: 10
-interactive: bash
-azureSandbox: true
-content: |
-  [!include[](includes/6-exercise-refactor-microservice.md)]
-
+### YamlMime:ModuleUnit
+uid: learn.microservices-architecture.6-exercise-refactor-microservice
+metadata:
+  title: Exercise - Refactor a service within the monolith as a microservice
+  description: Exercise - Refactor a service within the monolith as a microservice
+  ms.date: 07/08/2025
+  author: rmcmurray
+  ms.author: robmcm
+  ms.topic: unit
+  ms.custom:
+    - devx-track-azurecli
+title: Exercise - Refactor a service within the monolith as a microservice
+durationInMinutes: 10
+interactive: bash
+azureSandbox: true
+content: |
+  [!include[](includes/6-exercise-refactor-microservice.md)]
+
diff --git a/learn-pr/azure/microservices-architecture/7-summary.yml b/learn-pr/azure/microservices-architecture/7-summary.yml
@@ -1,14 +1,14 @@
-### YamlMime:ModuleUnit
-uid: learn.microservices-architecture.7-summary
-metadata:
-  title: Summary
-  description: Summary
-  ms.date: 02/02/2024
-  author: rmcmurray
-  ms.author: robmcm
-  ms.topic: unit
-title: Summary
-durationInMinutes: 2
-content: |
-  [!include[](includes/7-summary.md)]
-
+### YamlMime:ModuleUnit
+uid: learn.microservices-architecture.7-summary
+metadata:
+  title: Summary
+  description: Summary
+  ms.date: 07/08/2025
+  author: rmcmurray
+  ms.author: robmcm
+  ms.topic: unit
+title: Summary
+durationInMinutes: 2
+content: |
+  [!include[](includes/7-summary.md)]
+
diff --git a/learn-pr/azure/microservices-architecture/includes/1-introduction.md b/learn-pr/azure/microservices-architecture/includes/1-introduction.md
@@ -6,12 +6,12 @@ To support this new line of business, Fabrikam integrated new capabilities into
 
 ## Learning objectives
 
-In this module, you will:
+In this module, you'll:
 
 - Identify the properties and benefits of a microservices application.
 - Decompose a monolithic application into a microservices architecture.
 
 ## Prerequisites
 
-- Basic understanding of application and system architecture.
-- Basic knowledge of C#.
+- Basic understanding of application and system architecture
+- Basic knowledge of C#
diff --git a/learn-pr/azure/microservices-architecture/includes/2-monolith-microservices.md b/learn-pr/azure/microservices-architecture/includes/2-monolith-microservices.md
@@ -1,4 +1,4 @@
-Fabrikam integrated their new drone service into their existing application. They realize that this solution isn't a good long-term plan for their application. The existing system is a monolithic architecture, but what exactly does that mean?
+Fabrikam integrated their new drone service into their existing application. They realize this solution isn't a good long-term plan for their application. The existing system is a monolithic architecture, but what exactly does that mean?
 
 ## What is a monolithic architecture?
 
diff --git a/learn-pr/azure/microservices-architecture/includes/4-monolith-performance.md b/learn-pr/azure/microservices-architecture/includes/4-monolith-performance.md
@@ -18,4 +18,4 @@ The package service was identified as a critical part of the business and was or
 
 Because the package service is in the monolith, the team can't operate autonomously. They have to rely on shared data and data structures. They're also unable to iterate as quickly as they need. Along with the performance and scalability issues, this service is identified as a prime candidate for a microservice.
 
-Let's take a closer look at how Fabrikam can analyze and decompose their application to take advantage of a microservices architecture.
+Let's take a closer look at how Fabrikam can analyze and decompose their application to take advantage of a microservices architecture.
diff --git a/learn-pr/azure/microservices-architecture/includes/5-analyze-decompose.md b/learn-pr/azure/microservices-architecture/includes/5-analyze-decompose.md
@@ -54,11 +54,11 @@ Tactical DDD is when you define your domain models with more precision. The tact
 
 There are several tactical DDD patterns to consider:
 
-- **Entities:** An entity is an object with a unique identity that persists over time. For example, in a banking application, customers and accounts are entities.
-- **Value objects:** A value object has no identity. The values of its attributes define it, and it's immutable. Typical examples of value objects include colors, dates and times, and currency values.
-- **Aggregates:** An aggregate defines a consistency boundary around one or more entities. The purpose of an aggregate is to model transactional invariants. Things in the real world have complex webs of relationships. Customers create orders, orders contain products, products have suppliers, and so on. If the application modifies several related objects, how does it guarantee consistency? How do we keep track of invariants and enforce them?
-- **Domain and application services:** In DDD terminology, a service is an object that implements some logic without holding any state. Evans distinguishes between domain services, which encapsulate domain logic, and application services, which provide technical functionality. Application services typically include technical functionality such as user authentication or sending an SMS message. Domain services are often used to model behavior that spans multiple entities.
-- **Domain events:** Domain events can be used to notify other parts of the system when something happens. As the name suggests, domain events should mean something within the domain. For example, "a record was inserted into a table" isn't a domain event. "A delivery was canceled" is a domain event. Domain events are especially relevant in a microservices architecture. Because microservices are distributed and don't share data stores, domain events provide a way for microservices to coordinate with each other.
+- **Entities**: An entity is an object with a unique identity that persists over time. For example, in a banking application, customers and accounts are entities.
+- **Value objects**: A value object has no identity. The values of its attributes define it, and it's immutable. Typical examples of value objects include colors, dates and times, and currency values.
+- **Aggregates**: An aggregate defines a consistency boundary around one or more entities. The purpose of an aggregate is to model transactional invariants. Things in the real world have complex webs of relationships. Customers create orders, orders contain products, products have suppliers, and so on. If the application modifies several related objects, how does it guarantee consistency? How do we keep track of invariants and enforce them?
+- **Domain and application services**: In DDD terminology, a service is an object that implements some logic without holding any state. Evans distinguishes between domain services, which encapsulate domain logic, and application services, which provide technical functionality. Application services typically include technical functionality such as user authentication or sending an SMS message. Domain services are often used to model behavior that spans multiple entities.
+- **Domain events**: Domain events can be used to notify other parts of the system when something happens. As the name suggests, domain events should mean something within the domain. For example, "a record was inserted into a table" isn't a domain event. "A delivery was canceled" is a domain event. Domain events are especially relevant in a microservices architecture. Because microservices are distributed and don't share data stores, domain events provide a way for microservices to coordinate with each other.
 
 ![Diagram of the drone domain model.](../media/6-drone-ddd.svg)
 
@@ -78,7 +78,7 @@ The value objects in this design include Location, ETA, PackageWeight, and Packa
 
 There are two domain events:
 
-- While a drone is in flight, the drone entity sends DroneStatus events that describe the drone's location and status, for example, in-flight, landed.
+- While a drone is in flight, the drone entity sends DroneStatus events that describe the drone's location and status such as in-flight and landed.
 - The delivery entity sends DeliveryTracking events whenever the stage of a delivery changes. These events include DeliveryCreated, DeliveryRescheduled, DeliveryHeadedToDropoff, and DeliveryCompleted.
 
 Notice that these events describe things that are meaningful within the domain model. They describe something about the domain and aren't tied to a particular programming language construct.
diff --git a/learn-pr/azure/microservices-architecture/includes/7-summary.md b/learn-pr/azure/microservices-architecture/includes/7-summary.md
@@ -4,9 +4,9 @@ Your application architecture is likely to have more complexity, different chall
 
 To learn more about microservices, check out the following documents:
 
-- [Introduction to microservices](/azure/architecture/microservices/introduction)
+- [Microservices architecture design](/azure/architecture/microservices/introduction)
 - [Design a microservices architecture](/azure/architecture/microservices/design/)
-- [Use domain analysis to model microservices](/azure/architecture/microservices/model/domain-analysis)
+- [Using domain analysis to model microservices](/azure/architecture/microservices/model/domain-analysis)
 - [.NET microservices architecture guidance](https://dotnet.microsoft.com/learn/aspnet/microservices-architecture)
 
-For more background on domain-driven design, we recommend *Domain-Driven Design* by Eric Evans. This book first introduced the term, domain-driven design. Another good reference is *Implementing Domain-Driven Design* by Vaughn Vernon.
+For more background on domain-driven design, we recommend *Domain-Driven Design* by Eric Evans. This book first introduced the term, domain-driven design. Another good reference is *Implementing Domain-Driven Design* by Vaughn Vernon.
diff --git a/learn-pr/azure/microservices-architecture/index.yml b/learn-pr/azure/microservices-architecture/index.yml
@@ -1,42 +1,42 @@
-### YamlMime:Module
-uid: learn.microservices-architecture
-metadata:
-  title: Decompose a monolithic application into a microservices architecture
-  description: Improve development agility, deployment, fault tolerance, and scalability by modernizing your application with a microservices architecture.
-  ms.service: azure-functions
-  manager: mkluck
-  ms.date: 02/02/2024
-  author: rmcmurray
-  ms.author: robmcm
-  ms.topic: module
-title: Decompose a monolithic application into a microservices architecture
-summary: Improve development agility, deployment, fault tolerance, and scalability by modernizing your application with a microservices architecture.
-abstract: | 
-  In this module, you will:
-  - Identify the properties and benefits of a microservices application
-  - Decompose a monolithic application into a microservices architecture
-prerequisites: | 
-  - Basic understanding of application and system architecture
-  - Basic knowledge of C#
-iconUrl: /training/achievements/microservices-architecture.svg
-levels:
-- advanced
-roles:
-- solution-architect
-products:
-- azure
-- azure-functions
-- azure-app-service
-subjects:
-- architecture
-units:
-- learn.microservices-architecture.1-introduction
-- learn.microservices-architecture.2-monolith-microservices
-- learn.microservices-architecture.3-exercise-deploy-monolithic-app
-- learn.microservices-architecture.4-monolith-performance
-- learn.microservices-architecture.5-analyze-decompose
-- learn.microservices-architecture.6-exercise-refactor-microservice
-- learn.microservices-architecture.7-summary
-badge:
-  uid: learn.microservices-architecture.badge
-
+### YamlMime:Module
+uid: learn.microservices-architecture
+metadata:
+  title: Decompose a Monolithic Application into a Microservices Architecture
+  description: Improve development agility, deployment, fault tolerance, and scalability by modernizing your application with a microservices architecture.
+  ms.service: azure-functions
+  manager: mkluck
+  ms.date: 07/08/2025
+  author: rmcmurray
+  ms.author: robmcm
+  ms.topic: module
+title: Decompose a monolithic application into a microservices architecture
+summary: Improve development agility, deployment, fault tolerance, and scalability by modernizing your application with a microservices architecture.
+abstract: | 
+  In this module, you'll:
+  - Identify the properties and benefits of a microservices application.
+  - Decompose a monolithic application into a microservices architecture.
+prerequisites: | 
+  - Basic understanding of application and system architecture
+  - Basic knowledge of C#
+iconUrl: /training/achievements/microservices-architecture.svg
+levels:
+- advanced
+roles:
+- solution-architect
+products:
+- azure
+- azure-functions
+- azure-app-service
+subjects:
+- architecture
+units:
+- learn.microservices-architecture.1-introduction
+- learn.microservices-architecture.2-monolith-microservices
+- learn.microservices-architecture.3-exercise-deploy-monolithic-app
+- learn.microservices-architecture.4-monolith-performance
+- learn.microservices-architecture.5-analyze-decompose
+- learn.microservices-architecture.6-exercise-refactor-microservice
+- learn.microservices-architecture.7-summary
+badge:
+  uid: learn.microservices-architecture.badge
+

Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-Fabrikam integrated their new drone service into their existing application. They realize that this solution isn't a good long-term plan for their application. The existing system is a monolithic architecture, but what exactly does that mean?`
	`1`	`+Fabrikam integrated their new drone service into their existing application. They realize this solution isn't a good long-term plan for their application. The existing system is a monolithic architecture, but what exactly does that mean?`
`2`	`2`
`3`	`3`	`## What is a monolithic architecture?`
`4`	`4`
Original file line number	Diff line number	Diff line change
`@@ -18,4 +18,4 @@ The package service was identified as a critical part of the business and was or`
`18`	`18`
`19`	`19`	`Because the package service is in the monolith, the team can't operate autonomously. They have to rely on shared data and data structures. They're also unable to iterate as quickly as they need. Along with the performance and scalability issues, this service is identified as a prime candidate for a microservice.`
`20`	`20`
`21`		`-Let's take a closer look at how Fabrikam can analyze and decompose their application to take advantage of a microservices architecture.`
	`21`	`+Let's take a closer look at how Fabrikam can analyze and decompose their application to take advantage of a microservices architecture.`