Merge pull request #298815 from cephalin/overview2

rewrite overview

Author: JamesJBarnett

articles/app-service/operating-system-functionality.md

@@ -14,7 +14,7 @@ ms.custom: UpdateFrequency3
 This article describes the baseline operating system functionality that's available to all Windows apps running in [Azure App Service](./overview.md). This functionality includes file, network, and registry access, along with diagnostics logs and events.
 
 > [!NOTE]
-> [Linux apps](overview.md#app-service-on-linux) in App Service run in their own containers. You have root access to the container but no access to the host operating system. Likewise, for [apps running in Windows containers](quickstart-custom-container.md?pivots=container-windows), you have administrative access to the container but no access to the host operating system.
+> Linux apps in App Service run in their own containers. You have root access to the container but no access to the host operating system. Likewise, for [apps running in Windows containers](quickstart-custom-container.md?pivots=container-windows), you have administrative access to the container but no access to the host operating system.
 
 <a id="tiers"></a>
 

articles/app-service/overview-diagnostics.md

@@ -15,7 +15,7 @@ When you're running a web application, you want to be prepared for any problems
 
 Although this experience is most helpful when you're having problems with your app within the last 24 hours, all the diagnostic graphs are always available for you to analyze.
 
-App Service diagnostics works for not only apps on Windows, but also apps on [Linux or containers](./overview.md#app-service-on-linux), [App Service Environments](./environment/intro.md), and [Azure Functions](../azure-functions/functions-overview.md).
+App Service diagnostics works for not only apps on Windows, but also apps on built-in or custom containers, [App Service Environments](./environment/intro.md), and [Azure Functions](../azure-functions/functions-overview.md).
 
 ## Steps for opening App Service diagnostics
 

articles/app-service/overview-local-cache.md

@@ -42,7 +42,7 @@ Apps running with a local cache benefit in these ways:
 - They experience fewer app restarts from changes in the storage share.
 
 > [!NOTE]
-> The local cache feature isn't supported in function apps or containerized App Service apps, such as in [Windows containers](quickstart-custom-container.md?pivots=container-windows) or in [App Service on Linux](overview.md#app-service-on-linux). A version of the feature that's available for these app types is [App Cache](https://github.com/Azure-App-Service/KuduLite/wiki/App-Cache).
+> The local cache feature isn't supported in function apps or containerized App Service apps, such as in [Windows containers](quickstart-custom-container.md?pivots=container-windows) or in built-in or custom Linux containers. A version of the feature that's available for these app types is [App Cache](https://github.com/Azure-App-Service/KuduLite/wiki/App-Cache).
 >
 > The local cache feature also isn't supported in the F1 and D1 pricing tiers of App Service.
   

articles/app-service/overview.md

@@ -4,103 +4,50 @@ description: Learn how Azure App Service helps you develop and host web applicat
 
 ms.assetid: 94af2caf-a2ec-4415-a097-f60694b860b3
 ms.topic: overview
-ms.date: 03/18/2025
+ms.date: 04/24/2025
 ms.custom: UpdateFrequency3, linux-related-content
 ms.author: msangapu
 author: msangapu-msft
 ---
 
 # App Service overview
 
-[!INCLUDE [regionalization-note](./includes/regionalization-note.md)]
+Azure App Service is a platform that lets you run web applications, mobile back ends, and RESTful APIs without worrying about managing the underlying infrastructure. Think of it as a powerful web hosting service that takes care of all the heavy lifting for you, so can focus on creating great applications.
 
-*Azure App Service* is an HTTP-based service for hosting web applications, REST APIs, and mobile back ends. You can develop in your favorite language, be it .NET, .NET Core, Java, Node.js, Python, or PHP. Applications run and scale with ease on both Windows and [Linux](#app-service-on-linux)-based environments.
+App Serivce supports a variety of web stacks: .NET, Java (in Java SE, Tomcat, and JBoss flavors), Node.js, Python, and PHP, and can run them on both Windows and Linux. Or, if your app is containerized, you can just deploy it as a custom container.
 
-App Service adds the power of Microsoft Azure to your application, including improved security, load balancing, autoscaling, and automated management. Additionally, you can take advantage of its DevOps capabilities, such as continuous deployment from Azure DevOps, GitHub, Docker Hub, and other sources, package management, staging environments, custom domains, and TLS/SSL certificates.
+## Why Use Azure App Service?
 
-With App Service, you pay for the Azure compute resources you use. The *App Service plan* that you run your apps on determines the compute resources you use. For more information, see [Azure App Service plans overview](overview-hosting-plans.md).
+Whether you're a student, a small business, a startup, or an enterprise, App Service offers a wide range of features tailored to meet your needs.
 
-## Why use App Service?
+### Students
 
-Azure App Service is a fully managed platform as a service (PaaS) offering for developers. Here are some key features of App Service:
+- **Free access**: In addition to the widely-available [free tier](https://azure.microsoft.com/pricing/details/app-service/), students can take advantage of the [Azure for Students Starter](https://azure.microsoft.com/pricing/offers/ms-azr-0144p) program.
+- **IDE support**: Purpose-built deployment tools are available for Visual Studio, Visual Studio Code, IntelliJ, and Eclipse.
+- **Easy to use**: Run your apps without needing experience in infrastructure management.
+- **Learning Resources**: Plenty of tutorials and guides to help you get started.
 
-* **Multiple languages and frameworks** - App Service has first-class support for ASP.NET, ASP.NET Core, Java, Node.js, Python, and PHP. You can also run [PowerShell and other scripts or executables](webjobs-create.md) as background services.
-* **Managed production environment** - App Service automatically [patches and maintains the OS and language frameworks](overview-patch-os-runtime.md) for you. Spend time writing great apps and let Azure worry about the platform.
-* **Containerization and Docker** - Dockerize your app and host a custom Windows or Linux container in App Service. Run sidecar containers of your choice. Migrate your Docker skills directly to App Service.
-* **DevOps optimization** - Set up [continuous integration and deployment](deploy-continuous-deployment.md) with Azure DevOps, GitHub, Bitbucket, Docker Hub, or Azure Container Registry. Promote updates through [test and staging environments](deploy-staging-slots.md). Manage your apps in App Service by using [Azure PowerShell](/powershell/azure/) or the [cross-platform command-line interface (CLI)](/cli/azure/install-azure-cli).
-* **Global scale with high availability** - Scale [up](manage-scale-up.md) or [out](/azure/azure-monitor/autoscale/autoscale-get-started) manually or automatically. Host your apps anywhere in the global Microsoft datacenter infrastructure, and the App Service [SLA](https://azure.microsoft.com/support/legal/sla/app-service/) promises high availability.
-* **Connections to SaaS platforms and on-premises data** - Choose from [many hundreds of  connectors](/connectors/connector-reference/connector-reference-logicapps-connectors) for enterprise systems (such as SAP), SaaS services (such as Salesforce), and internet services (such as Facebook). Access on-premises data using [Hybrid Connections](app-service-hybrid-connections.md) and [Azure Virtual Network](./overview-vnet-integration.md).
-* **Security and compliance** - App Service is [ISO, SOC, and PCI compliant](https://www.microsoft.com/trust-center). Create [IP address restrictions](app-service-ip-restrictions.md) and [managed service identities](overview-managed-identity.md). [Protect against subdomain takeovers](reference-dangling-subdomain-prevention.md).
-* **Authentication** - [Authenticate users](overview-authentication-authorization.md) using the built-in authentication component. Authenticate users with [Microsoft Entra ID](configure-authentication-provider-aad.md), [Google](configure-authentication-provider-google.md), [Facebook](configure-authentication-provider-facebook.md), [X](configure-authentication-provider-twitter.md), or [Microsoft accounts](configure-authentication-provider-microsoft.md).
-* **Application templates** - Choose from an extensive list of application templates in the [Azure Marketplace](https://azure.microsoft.com/marketplace/), such as WordPress, Joomla, and Drupal.
-* **Visual Studio and Visual Studio Code integration** - Dedicated tools in Visual Studio and Visual Studio Code streamline the work of creating, deploying, and debugging.
-* **Java tools integration** - Develop and deploy to Azure without leaving your favorite development tools, such as Maven, Gradle, Visual Studio Code, IntelliJ, and Eclipse.
-* **API and mobile features** - App Service provides turn-key CORS support for RESTful API scenarios and simplifies mobile app scenarios by enabling authentication, offline data sync, push notifications, and more.
-* **Serverless code** - Run a code snippet or script on-demand without having to explicitly provision or manage infrastructure, and pay only for the compute time your code actually uses (see [Azure Functions](../azure-functions/index.yml)).
+### Small businesses and startups
 
-Besides App Service, Azure offers other services that can be used for hosting websites and web applications. 
-For most scenarios, App Service is the best choice. For a microservice architecture, 
-consider [Azure Kubernetes Service](/azure/aks/) or [Service Fabric](/azure/service-fabric/). 
-If you need more control over the VMs on which your code runs, consider 
-[Azure Virtual Machines](/azure/virtual-machines/). For more information about how to choose among these 
-Azure services, see [Azure App Service, Azure Kubernetes Service, Virtual Machines, and other cloud services 
-comparison](/azure/architecture/guide/technology-choices/compute-decision-tree).
+- **Brand security**: Protect your brand and your customers quickly with an [App Service domain](manage-custom-dns-buy-domain.md) and a [free managed certificate](configure-ssl-certificate.md). Or, bring your domain and certificate to App Service.
+- **Cost-effective**: Pay only for the resources you use, and scale [up](manage-scale-up.md) or [out](/azure/azure-monitor/autoscale/autoscale-get-started) with your business.
+- **Command-line friendly**: Deploy using command line tools you already use, such as Maven, Gradle, Azure Developer CLI, Azure CLI, and Azure PowerShell.
+- **Scalability**: Automatically scale your applications based on demand.
+- **Global reach**: Deploy your apps in data centers around the world.
+- **Application templates**: Choose from an extensive list of application templates in the [Azure Marketplace](https://azure.microsoft.com/marketplace/), such as WordPress, Joomla, and Drupal.
+- **Social sign-in support**: Turn-key social sign-in with [Google](configure-authentication-provider-google.md), [Facebook](configure-authentication-provider-facebook.md), [X](configure-authentication-provider-twitter.md), and [Microsoft accounts](configure-authentication-provider-microsoft.md).
 
-## App Service on Linux
+### Enterprises
 
-App Service can also host web apps natively on Linux for supported application stacks. It can also run custom Linux containers (also known as *Web App for Containers*).
+- **CI/CD**: [Deploy continuously](deploy-continuous-deployment.md) with GitHub Actions, Azure Pipelines, and more. Deploy predictably through [staging environments](deploy-staging-slots.md).
+- **High-density hosting savings**: Run more applications on fewer VMs with the memory-optimized [P*mv3 tiers](https://azure.microsoft.com/pricing/details/app-service/), and save up to 55% on predictable workloads with [Azure savings plans](https://azure.microsoft.com/pricing/offers/savings-plan-compute) and [reserved instances](https://azure.microsoft.com/pricing/reservations/).
+- **Full isolation**: Secure ingress and egress with [Azure Virtual Network integration](./tutorial-networking-isolate-vnet.md), or run fully isolated applications with [App Service environments](./environment/ase-multi-tenant-comparison.md), using dedicated networking and VMs.
+- **Line-of-business**: Develop business applications easily with built-in authentication, Microsoft Graph, and [connectors](/connectors/connector-reference/connector-reference-logicapps-connectors) to your line-of-business applications.
+- **Reliability**: Robust [SLA](https://azure.microsoft.com/support/legal/sla/app-service/) and zone redundancy features help disaster-proof your application.
+- **Security and compliance**: [ISO, SOC, and PCI compliance](https://www.microsoft.com/trust-center) meet the strictest requirements of large enterprises.
 
-### Built-in languages and frameworks
+For information about which Azure compute services best fit your scenario, see [Choose an Azure compute service](/azure/architecture/guide/technology-choices/compute-decision-tree).
 
-App Service on Linux supports a number of language-specific built-in images. Just deploy your code. 
-Supported languages include: .NET Core, Java (Tomcat, JBoss EAP, or Java SE with an embedded web server), 
-Node.js, Python, and PHP. Run [`az webapp list-runtimes --os linux`](/cli/azure/webapp#az-webapp-list-runtimes) 
-to view the latest languages and supported versions. If the runtime your application requires isn't supported 
-in the built-in images, you can deploy it with a custom container.
+## Next Steps
 
-Outdated runtimes are periodically removed from the Web Apps Create and Configuration blades in the portal. These runtimes are hidden from the portal when they're deprecated by the maintaining organization or found to have significant vulnerabilities. These options are hidden to guide customers to the latest runtimes, where they'll be the most successful.
-
-When an outdated runtime is hidden from the portal, any of your existing sites using that version will continue to run. If a runtime is fully removed from the App Service platform, your Azure subscription owner(s) will receive an email notice before the removal.
-
-If you need to create another web app with an outdated runtime version that's no longer shown on the portal, see the language configuration guides for instructions on how to get the runtime version of your site. You can use the Azure CLI to create another site with the same runtime. Alternatively, you can use the **Export Template** button on the web app blade in the portal to export an ARM template of the site. You can reuse this template to deploy a new site with the same runtime and configuration.
-
-### Limitations
-
-* App Service on Linux isn't supported on the [Shared](https://azure.microsoft.com/pricing/details/app-service/plans/) pricing tier.
-* The Azure portal shows only features that currently work for Linux apps. As features are enabled, they're activated on the portal.
-* When deployed to built-in images, your code and content are allocated a storage volume for web content, backed by Azure Storage. The disk latency of this volume is higher and more variable than the latency of the container filesystem. Apps that require heavy read-only access to content files might benefit from the custom container option, which places files in the container filesystem instead of on the content volume.
-
-## App Service Environment
-
-App Service Environment is an Azure App Service feature that provides a fully isolated and dedicated environment for running App Service apps with improved security at high scale. Unlike the App Service offering, where supporting infrastructure is shared, with App Service Environment, compute is dedicated to a single customer. For more information on the differences between App Service Environment and App Service, see the [comparison](./environment/ase-multi-tenant-comparison.md).
-
-## Next step
-
-Create your first web app.
-
-> [!div class="nextstepaction"]
-> [Getting started](getting-started.md)
-
-> [!div class="nextstepaction"]
-> [ASP.NET (on Windows)](./quickstart-dotnetcore.md?tabs=netframework48)
-
-> [!div class="nextstepaction"]
-> [ASP.NET Core (on Windows or Linux)](quickstart-dotnetcore.md)
-
-> [!div class="nextstepaction"]
-> [Java (on Windows or Linux)](quickstart-java.md)
-
-> [!div class="nextstepaction"]
-> [Node.js (on Windows or Linux)](quickstart-nodejs.md)
-
-> [!div class="nextstepaction"]
-> [Python (on Linux)](quickstart-python.md)
-
-> [!div class="nextstepaction"]
-> [PHP (on Windows or Linux)](quickstart-php.md)
-
-> [!div class="nextstepaction"]
-> [HTML](quickstart-html.md)
-
-> [!div class="nextstepaction"]
-> [Custom container (Windows or Linux)](tutorial-custom-container.md)
+- [Getting started with Azure App Service](getting-started.md)

articles/app-service/quickstart-python-1.md

@@ -13,7 +13,7 @@ ROBOTS: noindex
 
 # Quickstart: Create a Python app in Azure App Service on Linux
 
-In this quickstart, you deploy a Python web app to [App Service on Linux](overview.md#app-service-on-linux), Azure's highly scalable, self-patching web hosting service. You use the [Azure CLI](/cli/azure/install-azure-cli) locally from a Windows, Linux, or macOS environment to deploy a sample with either the Flask or Django frameworks. The web app you configure uses a free App Service tier, so you incur no costs in the course of this article.
+In this quickstart, you deploy a Python web app to [App Service on Linux](overview.md), Azure's highly scalable, self-patching web hosting service. You use the [Azure CLI](/cli/azure/install-azure-cli) locally from a Windows, Linux, or macOS environment to deploy a sample with either the Flask or Django frameworks. The web app you configure uses a free App Service tier, so you incur no costs in the course of this article.
 
 > [!TIP]
 > If you prefer to deploy apps through an IDE, see **[Deploy Python apps to App Service from Visual Studio Code](/azure/developer/python/tutorial-deploy-app-service-on-linux-01)**.

articles/app-service/quickstart-python-portal.md

@@ -12,7 +12,7 @@ ROBOTS: noindex
 
 # Quickstart: Create a Python app using Azure App Service on Linux (Azure portal)
 
-In this quickstart, you deploy a Python web app to [App Service on Linux](overview.md#app-service-on-linux), Azure's highly scalable, self-patching web hosting service. You use the Azure portal to deploy a sample with either the Flask or Django frameworks. The web app you configure uses a basic App Service tier that incurs a small cost in your Azure subscription.
+In this quickstart, you deploy a Python web app to [App Service on Linux](overview.md), Azure's highly scalable, self-patching web hosting service. You use the Azure portal to deploy a sample with either the Flask or Django frameworks. The web app you configure uses a basic App Service tier that incurs a small cost in your Azure subscription.
 
 ## Configure accounts
 

articles/app-service/quickstart-python.md

@@ -11,9 +11,7 @@ ms.custom: devx-azure-cli, devx-azure-portal, devx-vscode-azure-extension, devdi
 
 # Quickstart: Deploy a Python (Django, Flask, or FastAPI) web app to Azure App Service
 
-[!INCLUDE [regionalization-note](./includes/regionalization-note.md)]
-
-In this quickstart, you deploy a Python web app (Django, Flask, or FastAPI) to [Azure App Service](./overview.md#app-service-on-linux). Azure App Service is a fully managed web hosting service that supports Python apps hosted in a Linux server environment.
+In this quickstart, you deploy a Python web app (Django, Flask, or FastAPI) to [Azure App Service](./overview.md). Azure App Service is a fully managed web hosting service that supports Python apps hosted in a Linux server environment.
 
 To complete this quickstart, you need: