Skip to content

Commit

Permalink
draft
Browse files Browse the repository at this point in the history
  • Loading branch information
tdykstra committed Aug 12, 2024
1 parent 9689bc8 commit f543cf5
Show file tree
Hide file tree
Showing 5 changed files with 11 additions and 11 deletions.
4 changes: 2 additions & 2 deletions docs/core/tools/dotnet-workload-config.md
Original file line number Diff line number Diff line change
Expand Up @@ -23,15 +23,15 @@ dotnet workload config -?|-h|--help

The `dotnet workload config` command selects workload set update mode or manifests update mode. It can also display the currently selected update mode.

For more information about the `dotnet workload config` command, see [Configure workload sets](configure-workload-sets.md).
For more information about the `dotnet workload config` command, see [.NET SDK workload sets](dotnet-workload-sets.md).

## Options

[!INCLUDE [help](../../../includes/cli-help.md)]

- **`--update-mode <workload-set>|<manifests>`**

Controls whether updates should look for workload set versions or the latest version of each individual manifest. To display the current mode, specify this option without an argument. For more information, see [Configure workload sets](configure-workload-sets.md).
Controls whether updates should look for workload set versions or the latest version of each individual manifest. To display the current mode, specify this option without an argument. For more information, see [.NET SDK workload sets](dotnet-workload-sets.md).

## Examples

Expand Down
5 changes: 2 additions & 3 deletions docs/core/tools/dotnet-workload-install.md
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,7 @@ dotnet workload install -?|-h|--help

The `dotnet workload install` command installs one or more *optional workloads*. Optional workloads can be installed on top of the .NET SDK to provide support for various application types, such as [.NET MAUI](/dotnet/maui/what-is-maui) and [Blazor WebAssembly AOT](https://devblogs.microsoft.com/aspnet/asp-net-core-updates-in-net-6-preview-4/#blazor-webassembly-ahead-of-time-aot-compilation).

Workload versions installed are based the latest workload set or a specified workload set version, not necessarily the latest version available of each individual workload. For more information, see [Configure workload sets](configure-workload-sets.md). Workload set update mode is available since 8.0.400 SDK.
Workload versions installed are based the latest workload set or a specified workload set version, not necessarily the latest version available of each individual workload. For more information, see [.NET SDK workload sets](dotnet-workload-sets.md). Workload set update mode is available since 8.0.400 SDK.

Use [dotnet workload search](dotnet-workload-search.md) to learn what workloads are available to install.

Expand Down Expand Up @@ -92,8 +92,7 @@ The `dotnet workload update` command also downloads advertising manifests. The d

- **`--version`**

The workload set version to update to. Available since 8.0.400 SDK. For more information, see [Configure workload sets](configure-workload-sets.md).

The workload set version to update to. Available since 8.0.400 SDK. For more information, see [.NET SDK workload sets](dotnet-workload-sets.md).

## Examples

Expand Down
2 changes: 1 addition & 1 deletion docs/core/tools/dotnet-workload-restore.md
Original file line number Diff line number Diff line change
Expand Up @@ -61,7 +61,7 @@ For more information about the `dotnet workload` commands, see the [dotnet workl

- **`--version <VERSION>`**

The workload set version to update to. Available since 8.0.400 SDK. For more information, see [Configure workload sets](configure-workload-sets.md).
The workload set version to update to. Available since 8.0.400 SDK. For more information, see [.NET SDK workload sets](dotnet-workload-sets.md).

## Example

Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: Configure workload sets
description: "Learn how to use workload sets to keep workload versions in sync when you have multiple workloads in a project."
title: .NET SDK workload sets
description: "Learn how to use workload sets to control which versions of workloads get installed, updated, and restored."
author: tdykstra
ms.author: tdykstra
ms.service: dotnet
Expand All @@ -9,7 +9,7 @@ ms.date: 08/02/2024

#customer intent: As a developer using multiple workloads in a project, I want to keep my workload versions in sync so that I can avoid problems that might arise from conflicts betwween versions. Even if I only have one workload, I want to avoid having a workload be updated to a different version when I'm not expecting it.
---
# Configure workload sets
# .NET SDK workload sets

A workload set provides a single version number that represents a group of .NET SDK workloads. This enables you to install and update a combination of workload versions that ship at the same time and are known to work together. Workload sets are published to nuget.org with each release of the .NET SDK, under the package ID `Microsoft.NET.Workloads.<feature band>`

Expand All @@ -32,6 +32,7 @@ You can also:
In 8.0.400 SDK, the `dotnet workload` commands are in workload set update mode when it's explicitly selected. In [.NET 9 SDK](https://dotnet.microsoft.com/en-us/download/dotnet/9.0), `dotnet workload` commands are in workload set update mode by default.

## Update to the latest available workload set version

To update installed workloads to the latest workload set version available on the configured feeds, run these commands:

```dotnetcli
Expand Down
4 changes: 2 additions & 2 deletions docs/core/tools/dotnet-workload-update.md
Original file line number Diff line number Diff line change
Expand Up @@ -29,7 +29,7 @@ dotnet workload update -?|-h|--help

The `dotnet workload update` command updates all installed workloads to the newest available versions. It queries Nuget.org for updated workload manifests. It then updates local manifests, downloads new versions of the installed workloads, and removes all old versions of each workload.

If the command is in workload set mode, workloads are updated according to the workload set version, not the latest version of each individual workload. For more information, see [Configure workload sets](configure-workload-sets.md). Workload set mode is available since 8.0.400 SDK.
If the command is in workload set mode, workloads are updated according to the workload set version, not the latest version of each individual workload. For more information, see [.NET SDK workload sets](dotnet-workload-sets.md). Workload set mode is available since 8.0.400 SDK.

For more information about the `dotnet workload` commands, see the [dotnet workload install](dotnet-workload-install.md#description) command.

Expand Down Expand Up @@ -65,7 +65,7 @@ For more information about the `dotnet workload` commands, see the [dotnet workl

- **`--version`**

The workload set version to update to. Available since 8.0.400 SDK. For more information, see [Configure workload sets](configure-workload-sets.md).
The workload set version to update to. Available since 8.0.400 SDK. For more information, see [.NET SDK workload sets](dotnet-workload-sets.md).

## Examples

Expand Down

0 comments on commit f543cf5

Please sign in to comment.