Skip to content

Conversation

Copy link
Contributor

Copilot AI commented Dec 16, 2025

Relocate CLI command reference include files from the repository root /includes/ directory to /docs/core/tools/includes/ to colocate them with the documentation they support.

Changes

  • Moved 36 include files to docs/core/tools/includes/:

    • 32 cli-* option includes (e.g., cli-arch.md, cli-verbosity.md, cli-configuration.md)
    • 3 dotnet tool includes (dotnet-new-7-0-syntax.md, dotnet-restore-note-options.md, dotnet-tool-install-arch-options.md)
    • elevated-access-unix.md
  • Updated 67 CLI tool documentation files with new include paths:

    - [!INCLUDE [arch](../../../includes/cli-arch.md)]
    + [!INCLUDE [arch](includes/cli-arch.md)]
  • Kept dotnet-restore-note.md in root /includes/ as it's referenced by files outside the tools directory (docs/core/deploying/, docs/csharp/)

Original prompt

This section details on the original issue you should resolve

<issue_title>Move CLI include files to same directory as CLI command reference docs</issue_title>
<issue_description>### Describe the issue or suggestion

Move CLI include files from docs/includes to docs/core/tools/includes


Associated WorkItem - 510308</issue_description>

Comments on the Issue (you are @copilot in this section)


💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.


Internal previews

Toggle expand/collapse
📄 File 🔗 Preview link
docs/core/tools/dotnet-build.md dotnet build
docs/core/tools/dotnet-clean.md dotnet clean command
docs/core/tools/dotnet-new-install.md dotnet new install
docs/core/tools/dotnet-new-list.md docs/core/tools/dotnet-new-list
docs/core/tools/dotnet-new-uninstall.md dotnet new uninstall
docs/core/tools/dotnet-new-update.md dotnet new update
docs/core/tools/dotnet-new.md dotnet new <TEMPLATE>
docs/core/tools/dotnet-nuget-trust.md docs/core/tools/dotnet-nuget-trust
docs/core/tools/dotnet-pack.md dotnet pack
docs/core/tools/dotnet-package-add.md dotnet package add
docs/core/tools/dotnet-package-download.md dotnet package download
docs/core/tools/dotnet-package-list.md dotnet package list command
docs/core/tools/dotnet-package-search.md dotnet package search
docs/core/tools/dotnet-package-update.md docs/core/tools/dotnet-package-update
docs/core/tools/dotnet-publish.md dotnet publish
docs/core/tools/dotnet-restore.md dotnet restore command
docs/core/tools/dotnet-run.md dotnet run
docs/core/tools/dotnet-sln.md docs/core/tools/dotnet-sln
docs/core/tools/dotnet-store.md dotnet store
docs/core/tools/dotnet-test.md dotnet test command
docs/core/tools/dotnet-tool-exec.md dotnet tool exec
docs/core/tools/dotnet-tool-install.md docs/core/tools/dotnet-tool-install
docs/core/tools/dotnet-tool-restore.md dotnet tool restore
docs/core/tools/dotnet-tool-update.md dotnet tool update command
docs/core/tools/dotnet-watch.md dotnet watch
docs/core/tools/dotnet-workload-install.md docs/core/tools/dotnet-workload-install
docs/core/tools/dotnet-workload-repair.md dotnet workload repair
docs/core/tools/dotnet-workload-restore.md dotnet workload restore
docs/core/tools/dotnet-workload-search.md dotnet workload search command
docs/core/tools/dotnet-workload-update.md dotnet workload update

Note

This table shows preview links for the 30 files with the most changes. For preview links for other files in this PR, select OpenPublishing.Build Details within checks.

Copilot AI changed the title [WIP] Move CLI include files to correct directory Move CLI include files to docs/core/tools/includes Dec 16, 2025
Copilot AI requested a review from meaghanlewis December 16, 2025 00:43
@meaghanlewis meaghanlewis requested a review from adegeo December 16, 2025 16:52
@meaghanlewis meaghanlewis marked this pull request as ready for review December 16, 2025 16:52
@meaghanlewis meaghanlewis requested a review from a team as a code owner December 16, 2025 16:52
Copilot AI review requested due to automatic review settings December 16, 2025 16:52
Copy link
Contributor

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

This PR reorganizes CLI include files by moving them from the repository root /includes/ directory to /docs/core/tools/includes/ to colocate them with the CLI tool documentation they support.

  • Relocated 36 include files to better organize CLI documentation resources
  • Updated include paths in 67 CLI documentation files to reflect the new location
  • Preserved dotnet-restore-note.md in root /includes/ as it's referenced by files outside the tools directory

Reviewed changes

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

Show a summary per file
File Description
includes/cli-os.md Deleted from root location (moved to docs/core/tools/includes/)
includes/cli-arch.md Deleted from root location (moved to docs/core/tools/includes/)
docs/core/tools/includes/dotnet-tool-install-arch-options.md Updated relative path reference to dotnet-tool-install.md
docs/core/tools/includes/dotnet-restore-note-options.md Updated relative paths to dotnet-restore.md
docs/core/tools/includes/dotnet-new-7-0-syntax.md Updated relative path to enable-tab-autocomplete.md
docs/core/tools/includes/cli-version.md Updated relative path to dotnet-workload-sets.md
docs/core/tools/includes/cli-os.md Created in new location with updated relative paths
docs/core/tools/includes/cli-artifacts-path.md Updated relative path to artifacts-output.md
docs/core/tools/includes/cli-arch.md Created in new location with updated relative paths
docs/core/tools/includes/cli-advertising-manifests.md Updated relative path to dotnet-workload-install.md
docs/core/tools/*.md (67 files) Updated include paths from ../../../includes/ to includes/

Copy link
Contributor

@gewarren gewarren left a comment

Choose a reason for hiding this comment

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

lgtm

@meaghanlewis meaghanlewis merged commit e58248a into main Dec 16, 2025
11 checks passed
@meaghanlewis meaghanlewis deleted the copilot/move-cli-include-files branch December 16, 2025 18:54
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Move CLI include files to same directory as CLI command reference docs

3 participants