edits pt 2

Signed-off-by: Hannah Hunter <[email protected]>

Author: hhunter-ms

articles/azure-functions/durable-task-scheduler/durable-task-scheduler-framework.md

@@ -1,8 +1,60 @@
 ---
-title: Azure Functions Durable Task Scheduler framework options (preview)
+title: Azure Functions Durable Task Scheduler frameworks (preview)
 description: Learn about the orchestration frameworks available to you in Durable Task Scheduler.
 ms.topic: conceptual
 ms.date: 04/10/2025
 ---
 
-# Durable Task Scheduler framework options (preview)
+# Choose your Azure Functions Durable Task Scheduler framework (preview)
+
+The Durable Task Scheduler supports three orchestration frameworks:
+
+- [Durable Functions](#durable-task-scheduler-for-durable-functions)
+- [Durable Task SDKs, or "portable" SDKs](#durable-task-sdks)
+- [Durable Task Framework](#durable-task-framework) 
+
+The following table provides some considerations when choosing a framework.
+
+|Consideration | Durable Task SDKs | Durable Functions | Durable Task Framework|
+|--------------| --------------| ------------------| --------------------- | 
+|Hosting option| Azure Container Apps, Azure Kubernetes Service, Azure App Service, VMs | Azure Functions | Azure Container Apps, Azure Kubernetes Service, Azure App Service, VMs |
+|Language support | [.NET](https://github.com/microsoft/durabletask-dotnet/), [Python](https://github.com/microsoft/durabletask-python), [Java (coming soon)](https://github.com/microsoft/durabletask-java), [JavaScript (coming soon)](https://github.com/microsoft/durabletask-js) | [.NET](https://github.com/Azure/azure-functions-durable-extension), [Python](https://github.com/Azure/azure-functions-durable-python), [Java](https://github.com/microsoft/durabletask-java), [JavaScript](https://github.com/Azure/azure-functions-durable-js), [PowerShell](https://github.com/Azure/azure-functions-powershell-worker/tree/dev/examples/durable) | [.NET](https://github.com/Azure/durabletask) |
+|Official support| No | Yes | No |
+|Durable task scheduler emulator| Available | Available |Available |
+|Monitoring dashboard| Available | Available <sup>1</sup> | Available <sup>1</sup>|
+|[Durable Entities](https://learn.microsoft.com/azure/azure-functions/durable/durable-functions-entities)| Not supported | Supported | Not supported|
+|Other supported feature(s)| Scheduler| <li>Azure Functions triggers and bindings</li> <li> Supports all backend providers </li> |Supports all backend providers|
+
+*<sup>1</sup> The out-of-the-box monitoring dashboard is available only when using the Durable Task Scheduler as the backend provider.*
+
+> [!NOTE]
+> For all **new apps**, we recommend the [portable SDKs](#durable-task-sdks) over the [Durable Task Framework](#durable-task-framework), as the SDKs follow more modern .NET conventions.
+
+## Durable Task Scheduler for Durable Functions
+
+When used with Durable Functions, a feature of Azure Functions, the Durable Task Scheduler works as a fully managed backend provider, persisting state data as your app runs. While [other backend providers are supported](../durable/durable-functions-storage-providers.md), the Durable Task Scheduler offers a fully managed experience, which removes operational overhead. The scheduler offers exceptional performance, reliability, and the ease of monitoring orchestrations.
+
+The Durable Task Scheduler plays a similar role in the Durable Task Framework as in Durable Functions.
+
+[Learn how to configure the Durable Task Scheduler for your Durable Function app.](./quickstart-durable-task-scheduler.md)
+
+## Durable Task SDKs
+
+The [Durable Task SDKs][todo] provide a lightweight client library for the Durable Task Scheduler. When running orchestrations, apps using these SDKs connect to the scheduler's orchestration engine in Azure. You can host apps leveraging these "portable" SDKs in various compute environments, such as:
+- Azure Container Apps
+- Azure Kubernetes Service
+- Azure App Service
+- Virtual machines
+
+[Learn how to configure the Durable Task Scheduler using the portable SDKs.](./quickstart-portable-durable-task-sdks.md)
+
+## Durable Task Framework
+
+The [Durable Task Framework (DTFx)](https://github.com/Azure/durabletask) powers the serverless Durable Functions extension of Azure Functions. With the DTFx library, you can write long-running, persistent workflows (or *orchestrations*) in C# using simple async/await coding constructs. DTFx reliably orchestrates provisioning, monitoring, and management operations. The orchestrations scale out linearly by simply adding more worker machines. 
+
+[Try out the DTFx library via its GitHub repo.](https://github.com/Azure/durabletask/tree/main/samples)
+
+## Next steps
+
+> [!div class="nextstepaction"]
+> [Learn about the Dedicated SKU hosting plan](./durable-task-scheduler-dedicated-sku.md)

articles/azure-functions/durable-task-scheduler/durable-task-scheduler.md

@@ -1,11 +1,11 @@
 ---
-title: Azure Functions Durable Task Scheduler backend for Durable Functions (preview)
+title: Azure Functions Durable Task Scheduler (preview)
 description: Learn about the characteristics of the Azure Functions Durable Task Scheduler backend.
 ms.topic: conceptual
 ms.date: 04/10/2025
 ---
 
-# Azure Functions Durable Task Scheduler backend for Durable Functions (preview)
+# Azure Functions Durable Task Scheduler (preview)
 
 The Durable Task Scheduler provides durable execution in Azure. Durable execution is a fault-tolerant approach to running code that handles failures and interruptions through automatic retries and state persistence. Scenarios where durable execution is required:
 - Distributed transactions
@@ -19,28 +19,21 @@ The Durable Task Scheduler, coupled with a developer orchestration framework lik
 
 You can use the Durable Task Scheduler with the following orchestration frameworks:
 
-- [Durable Functions](./quickstart-durable-task-scheduler.md)
+- Durable Functions
 - Durable Task SDKs, or "portable SDKs"
-- [Durable Task Framework](https://github.com/Azure/durabletask)
-
-### Durable Task Scheduler for Durable Functions
-
-The Durable Task Scheduler is a fully managed backend for Durable Function apps. Compared with other Durable Functions storage providers, the scheduler provides several key benefits, including management, observability, performance, and security. 
-
-[Learn how to configure the Durable Task Scheduler for your Durable Function app.](./quickstart-durable-task-scheduler.md)
-
-## Durable 
+- Durable Task Framework
 
+[Learn which orchestration works better for your project.](./durable-task-scheduler-framework.md)
 
 ## Architecture
 
-For both the Durable Task Scheduler service for Durable Functions and the Durable Task SDKs, instances of the Durable Task Scheduler can be created using Azure Resource Manager and are of type [Microsoft.DurableTask/scheduler](/azure/templates/microsoft.durabletask/schedulers). Each *scheduler* resource internally has its own dedicated compute and memory resources optimized for:
+For all Durable Task Scheduler orchestration frameworks, instances of the Durable Task Scheduler can be created using Azure Resource Manager and are of type [Microsoft.DurableTask/scheduler](/azure/templates/microsoft.durabletask/schedulers). Each *scheduler* resource internally has its own dedicated compute and memory resources optimized for:
 
 - Dispatching orchestrator, activity, and entity work items
 - Storing and querying history at scale with minimal latency
-- Providing a rich monitoring experience through the Durable Task Scheduler dashboard.
+- Providing a rich monitoring experience through [the Durable Task Scheduler dashboard](./durable-task-scheduler-dashboard.md)
 
-Unlike the BYO storage providers, the Durable Task Scheduler provider is a purpose-built backend-as-a-service optimized for the specific needs of the Durable Task Framework.
+Unlike [the BYO storage providers](../durable/durable-functions-storage-providers.md), the Durable Task Scheduler provider is a purpose-built backend-as-a-service optimized for the specific needs of the Durable Task Framework.
 
 The following diagram shows the architecture of the Durable Task Scheduler backend and its interaction with connected apps.