Merge pull request #11599 from stephen-sumner/rwadotnetupdates

Reliable web app pattern (RWA) 1.1 updates (.NET and Java)

docs/web-apps/guides/reliable-web-app/dotnet/apply-pattern.yml

@@ -2,7 +2,7 @@
 metadata:
   title: Reliable web app pattern for .NET - Apply the pattern
   titleSuffix: Azure Reference Architectures
-  description: Apply the reliable web app pattern for .NET to your web app. Find essential implementation guidance for web apps moving to the cloud. Learn how to update (re-platform) web apps to be successful in the cloud.
+  description: Apply the reliable web app pattern for .NET to your web app. Find essential implementation guidance for migrating web apps to the cloud. Learn how to update (replatform) web apps to be successful in the cloud.
   author: stephen-sumner
   ms.author: keschlob
   ms.reviewer: ssumner
@@ -23,7 +23,7 @@ products:
   - azure-cache-redis
   - dotnet
 name: Reliable web app pattern for .NET - Apply the pattern
-summary: Apply the reliable web app pattern for .NET to your web app. Find essential implementation guidance for web apps moving to the cloud. Learn how to update (re-platform) web apps to be successful in the cloud.
-thumbnailUrl: /azure/architecture/browse/thumbs/reliable-web-app-dotnet.png
+summary: Apply the reliable web app pattern for .NET to your web app. Find essential implementation guidance for migrating web apps to the cloud. Learn how to update (replatform) web apps to be successful in the cloud.
+thumbnailUrl: /azure/architecture/browse/thumbs/reliable-web-app-dotnet-1.1.svg
 content: |
    [!include[](apply-pattern-content.md)]

docs/web-apps/guides/reliable-web-app/dotnet/plan-implementation.yml

@@ -2,7 +2,7 @@
 metadata:
   title: Reliable web app pattern for .NET - Plan the implementation
   titleSuffix: Azure Reference Architectures
-  description: Plan the implementation of the reliable web app pattern for .NET. Find essential design guidance for web apps moving to the cloud. Learn how to update (re-platform) web apps to be successful in the cloud.
+  description: Plan the implementation of the reliable web app pattern for .NET. Find essential design guidance for migrating web apps to the cloud. Learn how to update (replatform) web apps to be successful in the cloud.
   author: stephen-sumner
   ms.author: keschlob
   ms.reviewer: ssumner
@@ -21,7 +21,7 @@ products:
   - azure-cache-redis
   - dotnet
 name: Reliable web app pattern for .NET - Plan the implementation
-summary: Plan the implementation of the reliable web app pattern for .NET. Find essential design guidance for web apps moving to the cloud. Learn how to update (re-platform) web apps to be successful in the cloud.
-thumbnailUrl: /azure/architecture/browse/thumbs/reliable-web-app-dotnet.png
+summary: Plan the implementation of the reliable web app pattern for .NET. Find essential design guidance for migrating web apps to the cloud. Learn how to update (replatform) web apps to be successful in the cloud.
+thumbnailUrl: /azure/architecture/browse/thumbs/reliable-web-app-dotnet-1.1.svg
 content: |
    [!include[](plan-implementation-content.md)]

docs/web-apps/guides/reliable-web-app/java/apply-pattern.yml

@@ -2,7 +2,7 @@
 metadata:
   title: Reliable web app pattern for Java - Apply the pattern
   titleSuffix: Azure Reference Architectures
-  description: Apply the reliable web app pattern for Java to your web app. Find essential implementation guidance for web apps moving to the cloud. Learn how to update (re-platform) web apps to be successful in the cloud.
+  description: Apply the reliable web app pattern for Java to your web app. Find essential implementation guidance for web apps moving to the cloud. Learn how to update (replatform) web apps to be successful in the cloud.
   author: stephen-sumner
   ms.author: ndalalelis
   ms.reviewer: ssumner
@@ -22,7 +22,7 @@ products:
   - azure-cache-redis
   - msal-java
 name: Reliable web app pattern for Java - Apply the pattern
-summary: Apply the reliable web app pattern for Java to your web app. Find essential implementation guidance for web apps moving to the cloud. Learn how to update (re-platform) web apps to be successful in the cloud.
-thumbnailUrl: /azure/architecture/browse/thumbs/reliable-web-app-java.png
+summary: Apply the reliable web app pattern for Java to your web app. Find essential implementation guidance for migrating web apps to the cloud. Learn how to update (replatform) web apps to be successful in the cloud.
+thumbnailUrl: /azure/architecture/browse/thumbs/reliable-web-app-java-1.1.svg
 content: |
    [!include[](apply-pattern-content.md)]

docs/web-apps/guides/reliable-web-app/java/plan-implementation.yml

@@ -2,7 +2,7 @@
 metadata:
   title: Reliable web app pattern for Java - Plan the implementation
   titleSuffix: Azure Reference Architectures
-  description: Plan the implementation of the reliable web app pattern for Java. Find essential design guidance for web apps moving to the cloud. Learn how to update (re-platform) web apps to be successful in the cloud.
+  description: Plan the implementation of the reliable web app pattern for Java. Find essential design guidance for web apps moving to the cloud. Learn how to update (replatform) web apps to be successful in the cloud.
   author: stephen-sumner
   ms.author: ndalalelis
   ms.reviewer: ssumner
@@ -20,7 +20,7 @@ products:
   - azure-database-postgresql
   - msal-java
 name: Reliable web app pattern for Java - Plan the implementation
-summary: Plan the implementation of the reliable web app pattern for Java. Find essential design guidance for web apps moving to the cloud. Learn how to update (re-platform) web apps to be successful in the cloud.
-thumbnailUrl: /azure/architecture/browse/thumbs/reliable-web-app-java.png
+summary: Plan the implementation of the reliable web app pattern for Java. Find essential design guidance for migrating web apps to the cloud. Learn how to update (replatform) web apps to be successful in the cloud.
+thumbnailUrl: /azure/architecture/browse/thumbs/reliable-web-app-java-1.1.svg
 content: |
    [!include[](plan-implementation-content.md)]

docs/web-apps/guides/reliable-web-app/overview.md

@@ -1,6 +1,6 @@
 ---
-title: Reliable web app pattern
-description: Learn about the reliable web app pattern.
+title: Reliable Web App pattern
+description: Learn about the Reliable Web App pattern.
 author: stephen-sumner    
 ms.author: ssumner
 ms.reviewer: ssumner
@@ -11,31 +11,37 @@ ms.subservice: azure-guide
 azureCategories:
     - web
     - developer-tools
-    - databases
     - devops
 products:
   - azure
-  - azure-app-service
-  - azure-cache-redis
 categories:
   - web
 ---
 
-# Reliable web app pattern
+# Reliable Web App pattern
 
-The reliable web app pattern provides essential implementation guidance for web apps moving to the cloud. It defines how you should update (re-platform) your web app to be successful in the cloud. The reliable web app pattern focuses on minimal code changes, reliability design patterns, and managed services so you can rapidly adopt the cloud (*see figure 1*).
+The Reliable Web App pattern aims to streamline the process of moving web applications to the cloud. It provides a systematic method for quickly adopting cloud technologies for on-premises web applications. Organizations migrating to the cloud should follow the Cloud Adoption Framework and establish a [landing zone](/azure/cloud-adoption-framework/ready/landing-zone/) for their web applications. The Reliable Web App pattern details strategies for replatforming your web application to ensure a successful migration to the cloud.
 
-[![Diagram showing the principles of the reliable web app pattern](../_images/reliable-web-app-overview.svg)](../_images/reliable-web-app-overview.svg#lightbox)
-*Figure 1. Overview of the reliable web app pattern.*
+[![Diagram showing the principles of the Reliable Web App](../_images/eap-overview.svg)](../_images/eap-overview.svg#lightbox)
 
-The reliable web app pattern builds on the principles of the Azure Well-Architected Framework. It focuses on several well-architected principles that are essential for the entire cloud adoption journey. The reliable web app pattern helps ensure web apps are cost optimized, observable, and ingress secure. The pattern also shows you how to implement infrastructure as code and identity-centric security.
+## Principles and implementation techniques
+
+The [Well-Architected Framework](/azure/well-architected/pillars) establishes the overriding principles of the Reliable Web App pattern. The Reliable Web App pattern goes beyond these original principles to derive subordinate principles specific to the process of migrating web apps to the cloud. Within these principles, the Reliable Web App Pattern focuses on making minimal code changes, applying reliability design patterns, and using managed services. It helps you create a web app that is cost optimized, observable, and ingress secure using infrastructure as code and identity-centric security.
+
+| Reliable Web App pattern principles | Implementation techniques |
+| --- | --- |
+| <br>▪ Minimal code changes<br>▪ Reliability design patterns<br>▪ Managed services<br>▪ Cost optimized<br>▪ Observable<br>▪ Ingress secure<br>▪ Infrastructure as code<br>▪ Identity-centric security|▪ Retry pattern <br> ▪ Circuit-breaker pattern <br>▪ Cache-aside pattern <br>▪ Rightsized resources <br>▪ Managed identities <br>▪ Private endpoints <br>▪ Secrets management <br>▪ Bicep (.NET) and Terraform (Java) deployment <br>▪ Telemetry, logging, monitoring |
+
+## Web app architecture
+
+It's important to note that the Reliable Web App pattern isn't a one-size-fits-all set of services or a specific architecture. The unique needs of your business and the characteristics of your existing web application are crucial in determining the most suitable architecture and network topology.
 
 ## Next steps
 
-There's specific implementation guidance for .NET and Java web apps. There's a reference implementation (sample web app) for both .NET and Java. The reference implementation has the reliable web app pattern applied. You should follow right guidance for your web app and use the reference implementation to expedite your progress.
+There's Reliable Web App pattern guidance for .NET and Java web applications. Use the guidance and reference implementations to accelerate your move to Azure.
 
 >[!div class="nextstepaction"]
->[Reliable web app pattern for .NET](./dotnet/plan-implementation.yml)
+>[Reliable Web App pattern for .NET](./dotnet/plan-implementation.yml)
 
 >[!div class="nextstepaction"]
->[Reliable web app pattern for Java](./java/plan-implementation.yml)
+>[Reliable Web App pattern for Java](./java/plan-implementation.yml)