Skip to content

Conversation

Copilot
Copy link
Contributor

@Copilot Copilot AI commented Sep 24, 2025

Summary

Updates the workload search command description in the top-level dotnet workload -h help output to make it clear that users can search for both workloads and workload versions.

Problem

The current help output only mentions searching for workloads:

search <SEARCH_STRING>        Search for available workloads.

However, the dotnet workload search version subcommand provides powerful functionality for searching workload sets and versions, which was not discoverable from the main help. Users had to know about this capability or stumble upon it by running dotnet workload search -h.

Solution

Updated the WorkloadSearchCommandDescription resource string from:

  • Before: "Search for available workloads."
  • After: "Search for available workloads or workload versions."

This change makes the version searching capability immediately discoverable when users run dotnet workload -h.

Impact

  • Improved discoverability: Users can now easily find the workload version search functionality
  • Better user experience: No need to dig into subcommand help to discover version search capabilities
  • Minimal change: Only the help text was updated, no functional changes to any commands
  • Preserved localization: All .xlf files were automatically updated with proper review states

The dotnet workload search version command provides three different search modes:

  1. List latest workload versions from the current feature band
  2. Show workload manifest versions for a specific workload version
  3. Find workload versions matching specific workload@version combinations

These capabilities are now more discoverable thanks to the improved help text.

Fixes #50981


💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

@Copilot Copilot AI changed the title [WIP] Improve workload help for workload set searching Improve workload search help text to clarify version searching capability Sep 24, 2025
@Copilot Copilot AI requested a review from marcpopMSFT September 24, 2025 17:05
Copilot finished work on behalf of marcpopMSFT September 24, 2025 17:05
@marcpopMSFT marcpopMSFT force-pushed the copilot/fix-c24951fb-7009-4f6e-b24d-036b6633c88c branch from db308c0 to 8b63493 Compare October 1, 2025 23:27
@marcpopMSFT
Copy link
Member

Text is updated for the help description. It still lists <SEARCH_STRING> in the help but I think that's a S.CL issue and probably ok.

@marcpopMSFT marcpopMSFT marked this pull request as ready for review October 1, 2025 23:28
Copy link
Contributor

@Copilot Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull Request Overview

Updates the workload search command description to clarify that users can search for both workloads and workload versions, improving discoverability of the dotnet workload search version functionality.

Key changes:

  • Enhanced help text from "Search for available workloads." to "Search for available workloads or workload versions."
  • Updated all localization files with proper review states to maintain translation consistency

Reviewed Changes

Copilot reviewed 14 out of 14 changed files in this pull request and generated no comments.

File Description
src/Cli/dotnet/Commands/CliCommandStrings.resx Updated main resource string for workload search command description
src/Cli/dotnet/Commands/xlf/CliCommandStrings.*.xlf Updated localization files with new source text and needs-review-translation state

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Improve workload help for workload set searching
3 participants