Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Update functions.md #2276

Open
wants to merge 1 commit into
base: main
Choose a base branch
from
Open

Update functions.md #2276

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Jump to
Jump to file
Failed to load files.
Diff view
Diff view
94 changes: 57 additions & 37 deletions api/overview/azure/latest/functions.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -9,40 +9,60 @@ ms.devlang: dotnet
ms.service: functions
ms.date: 10/15/2019
---
# Azure Functions libraries for .NET

## Overview

[Azure Functions](/azure/azure-functions/functions-overview) is a solution for easily running small pieces of code, or _functions_, in Azure. Azure Functions supports a [serverless](https://azure.microsoft.com/solutions/serverless/) execution model.

## Durable Functions extension

*Durable Functions* is an extension of [Azure Functions](/azure/azure-functions/functions-overview) that lets you write stateful functions in a serverless compute environment. The extension lets you define stateful workflows by writing [*orchestrator functions*](/azure/azure-functions/durable/durable-functions-orchestrations) and stateful entities by writing [*entity functions*](/azure/azure-functions/durable/durable-functions-entities) using the Azure Functions programming model. Behind the scenes, the extension manages state, checkpoints, and restarts for you, allowing you to focus on your business logic.

Install the extension [NuGet package](https://www.nuget.org/packages/Microsoft.Azure.WebJobs.Extensions.DurableTask) directly from the Visual Studio [Package Manager console][PackageManager] or with the [.NET Core CLI][DotNetCLI].

The Azure API reference documentation supports [version 2.x of the Durable Functions extension](/dotnet/api/overview/azure/functions/runtime).

### Visual Studio package manager

```powershell
Install-Package Microsoft.Azure.WebJobs.Extensions.DurableTask
```

### .NET Core CLI

```dotnetcli
dotnet add package Microsoft.Azure.WebJobs.Extensions.DurableTask
```

### Getting started

> [!div class="nextstepaction"]
> [Durable Functions quickstart](/azure/azure-functions/durable/durable-functions-create-first-csharp)

## Samples

View the [complete list](/samples/browse/?products=azure-functions&languages=csharp) of Azure Functions samples.

[PackageManager]: /nuget/tools/package-manager-console
[DotNetCLI]: /dotnet/core/tools/dotnet-add-package
# Azure Functions libraries for .NET

## Overview

[Azure Functions](/azure/azure-functions/functions-overview) is a solution for easily running small pieces of code, or _functions_, in Azure. Azure Functions supports a [serverless](https://azure.microsoft.com/solutions/serverless/) execution model.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Avoid the term "easily". It's subjective and would be best suited for marketing material.

Suggested change
[Azure Functions](/azure/azure-functions/functions-overview) is a solution for easily running small pieces of code, or _functions_, in Azure. Azure Functions supports a [serverless](https://azure.microsoft.com/solutions/serverless/) execution model.
[Azure Functions](/azure/azure-functions/functions-overview) is a solution for running small pieces of code, or _functions_, in Azure. Azure Functions supports a [serverless](https://azure.microsoft.com/solutions/serverless/) execution model.


## In-process and isolated worker process

Azure Functions supports two process models for running .NET functions. Read more about [differences between in-process and isolated worker process](https://learn.microsoft.com/azure/azure-functions/dotnet-isolated-in-process-differences).

## Durable Functions extension

*Durable Functions* is an extension of [Azure Functions](/azure/azure-functions/functions-overview) that lets you write stateful functions in a serverless compute environment. The extension lets you define stateful workflows by writing [*orchestrator functions*](/azure/azure-functions/durable/durable-functions-orchestrations) and stateful entities by writing [*entity functions*](/azure/azure-functions/durable/durable-functions-entities) using the Azure Functions programming model. Behind the scenes, the extension manages state, checkpoints, and restarts for you, allowing you to focus on your business logic.

Install the extension [NuGet package](https://www.nuget.org/packages/Microsoft.Azure.WebJobs.Extensions.DurableTask) directly from the Visual Studio [Package Manager console][PackageManager] or with the [.NET Core CLI][DotNetCLI].
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Install the extension [NuGet package](https://www.nuget.org/packages/Microsoft.Azure.WebJobs.Extensions.DurableTask) directly from the Visual Studio [Package Manager console][PackageManager] or with the [.NET Core CLI][DotNetCLI].
Install the extension [NuGet package](https://www.nuget.org/packages/Microsoft.Azure.WebJobs.Extensions.DurableTask) directly from the Visual Studio [Package Manager Console][PackageManager] or with the [.NET CLI][DotNetCLI].

Copy link

@jviau jviau Jan 27, 2023 •
edited

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[NuGet package](https://www.nuget.org/packages/Microsoft.Azure.WebJobs.Extensions.DurableTask)

This package applies to only the in-process model. Will this confuse readers that we are advising them to install this here, but for isolated they actually do not want to install it? Maybe instead this section can direct the reader to the following sections which give the correct package for in-process vs isolated?


The Azure API reference documentation supports [version 2.x of the Durable Functions extension](/dotnet/api/overview/azure/functions/runtime).

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change


## In-process

### Visual Studio package manager
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
### Visual Studio package manager
### Visual Studio


```powershell
Install-Package Microsoft.Azure.WebJobs.Extensions.DurableTask
```

### .NET Core CLI
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
### .NET Core CLI
### .NET CLI


```dotnetcli
dotnet add package Microsoft.Azure.WebJobs.Extensions.DurableTask
```
## Isolated worker process

### Visual Studio package manager
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
### Visual Studio package manager
### Visual Studio


```powershell
Install-Package Microsoft.Azure.Functions.Worker.Extensions.DurableTask
```

### .NET Core CLI
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
### .NET Core CLI
### .NET CLI


```dotnetcli
dotnet add package Microsoft.Azure.Functions.Worker.Extensions.DurableTask
```

### Getting started
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Avoid gerunds in section headings, when possible

Suggested change
### Getting started
### Get started


> [!div class="nextstepaction"]
> [Durable Functions quickstart](/azure/azure-functions/durable/durable-functions-create-first-csharp)

## Samples

View the [complete list](/samples/browse/?products=azure-functions&languages=csharp) of Azure Functions samples.

[PackageManager]: /nuget/tools/package-manager-console
[DotNetCLI]: /dotnet/core/tools/dotnet-add-package