Merge pull request #51108 from ShawnKupfer/WB1846

AB#1058606: Provide context with the right depth layer

Author: JamesJBarnett

learn-pr/azure/tm-provide-context-with-the-right-depth-layer/1-introduction.yml

@@ -4,7 +4,7 @@ title: Introduction
 metadata:
   title: Introduction
   description: Learn how to provide the right context in your data-flow diagrams with depth layers
-  ms.date: 05/05/2023
+  ms.date: 06/25/2025
   author: rodsan
   ms.author: rodsan
   ms.topic: unit

learn-pr/azure/tm-provide-context-with-the-right-depth-layer/1b-depth-layers.yml

@@ -4,7 +4,7 @@ title: Data-flow diagram depth layers
 metadata:
   title: Data-Flow Diagram Depth Layers
   description: Learn the differences between each data-flow diagram depth layer
-  ms.date: 05/05/2023
+  ms.date: 06/25/2025
   author: rodsan
   ms.author: rodsan
   ms.topic: unit

learn-pr/azure/tm-provide-context-with-the-right-depth-layer/2-layer-0-the-system-layer.yml

@@ -4,7 +4,7 @@ title: Layer 0 - The system layer
 metadata:
   title: Layer 0 - The system layer
   description: Learn what Layer 0 is and when to use it
-  ms.date: 05/05/2023
+  ms.date: 06/25/2025
   author: rodsan
   ms.author: rodsan
   ms.topic: unit
@@ -14,7 +14,7 @@ content: |
 quiz:
   title: "Check your knowledge"
   questions:
-  - content: "Layer 0 is commonly referred to as the: "
+  - content: "Layer 0 is commonly referred to as the:"
     choices:
     - content: "Context Layer"
       isCorrect: true

learn-pr/azure/tm-provide-context-with-the-right-depth-layer/3-layer-1-the-process-layer.yml

@@ -4,7 +4,7 @@ title: Layer 1 - The process layer
 metadata:
   title: Layer 1 - The Process Layer
   description: Learn what Layer 1 is and when to use it
-  ms.date: 05/05/2023
+  ms.date: 06/25/2025
   author: rodsan
   ms.author: rodsan
   ms.topic: unit

learn-pr/azure/tm-provide-context-with-the-right-depth-layer/4-layer-2-the-sub-process-layer.yml

@@ -4,7 +4,7 @@ title: Layer 2 - The subprocess layer
 metadata:
   title: Layer 2 - The Subprocess Layer
   description: Learn what Layer 2 is and when to use it
-  ms.date: 05/05/2023
+  ms.date: 06/25/2025
   author: rodsan
   ms.author: rodsan
   ms.topic: unit

learn-pr/azure/tm-provide-context-with-the-right-depth-layer/5-layer-3-the-lower-level-layer.yml

@@ -4,7 +4,7 @@ title: Layer 3 - The lower-level layer
 metadata:
   title: Layer 3 - The Lower-Level Layer
   description: Learn what Layer 3 is and when to use it
-  ms.date: 05/05/2023
+  ms.date: 06/25/2025
   author: rodsan
   ms.author: rodsan
   ms.topic: unit

learn-pr/azure/tm-provide-context-with-the-right-depth-layer/6-summary.yml

@@ -4,7 +4,7 @@ title: Summary
 metadata:
   title: Summary
   description: Review what you've learned about threat model context depth layers
-  ms.date: 05/05/2023
+  ms.date: 06/25/2025
   author: rodsan
   ms.author: rodsan
   ms.topic: unit

learn-pr/azure/tm-provide-context-with-the-right-depth-layer/includes/1-introduction.md

@@ -4,7 +4,7 @@ Threat modeling gives engineers the ability to graphically describe their system
 
 Threat models can either get too complex or too high-level, depending on the system you're building and the required context.
 
-Data-flow diagram depth layers help you understand how much context to include. In this module, you learn about data-flow diagram depth layers and when to use them.
+Data-flow diagram depth layers help you understand how much context to include. In this module, you'll learn about data-flow diagram depth layers and when to use them.
 
 > [!TIP]
 > Talk to your colleagues and security team to select the right depth layer. You can also use this module as reference.

learn-pr/azure/tm-provide-context-with-the-right-depth-layer/includes/1b-depth-layers.md

@@ -4,8 +4,8 @@ Every system should have a high-level overview of how it works. Most should have
 
 Examples include:
 
-- A process parsing highly sensitive data
-- Third-party authentication systems
+- A process parsing highly sensitive data.
+- Third-party authentication systems.
 
 At a high level, there are four depth layers used in threat modeling:
 

learn-pr/azure/tm-provide-context-with-the-right-depth-layer/includes/2-layer-0-the-system-layer.md

@@ -2,14 +2,14 @@ The system layer of data-flow diagrams is the starting point for any system. You
 
 **Goal**: Represent **major system parts** with enough context to help you understand how they work and interact with each other.
 
-Data-flow diagrams in the system layer should fit in a single page. They should also contain only major processes handled by the system. Provide as much as context as possible and clearly label each element so anyone understands how it works.
+Data-flow diagrams in the system layer should fit in a single page. They should also contain only major processes handled by the system. Provide as much as context as possible and clearly label each element so anyone can understand how it works.
 
 > [!TIP]
 > The **system layer** is also called the **context layer**.
 
 ## When to use the system layer
 
-The system layer should be required for every system you create. The high-level context helps anyone learn more about your system so they can engage in more meaningful discussions.
+The system layer should be required for every system you create. The high-level context can help anyone learn more about your system so they can engage in more meaningful discussions.
 
 ## Deep diving into a system part