Skip to content

Conversation

Copy link
Contributor

Copilot AI commented Jan 29, 2026

Two documentation files existed for adding azd commands: new-azd-command.md (1,325 lines, comprehensive) and adding-command.md (211 lines, basic subset).

Changes

  • Removed cli/azd/docs/style-guidelines/adding-command.md
    • All content covered by new-azd-command.md with greater depth
    • No references found in codebase (grep across .md, .go, .yaml, .yml)
    • Newer file includes complete examples, IoC patterns, and output formatting guidance absent from older doc

Single source of truth now: docs/style-guidelines/new-azd-command.md

Original prompt

This section details on the original issue you should resolve

<issue_title>Tidy duplicate files</issue_title>
<issue_description>We have two docs that are guidance on adding a new command:

  • Primary doc: /main/cli/azd/docs/style-guidelines/new-azd-command.md

  • Older secondary doc: /main/cli/azd/docs/style-guidelines/adding-command.md

  • Please check if there is anything that is in the older doc that needs to be pulled into the primary doc that is more current/recent.

  • Check throughout the codebase to see if the secondary file is mentioned, and if so update the pointer reference to the most current doc on adding a new command.

  • After you've completed the first two tasks, then delete the second file.
    </issue_description>

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


💡 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 AI changed the title [WIP] Tidy duplicate files in command documentation Remove duplicate command authoring documentation Jan 29, 2026
Copilot AI requested a review from kristenwomack January 29, 2026 18:36
@kristenwomack kristenwomack marked this pull request as ready for review January 29, 2026 19:25
@kristenwomack kristenwomack requested a review from wbreza as a code owner January 29, 2026 19:25
Copilot AI review requested due to automatic review settings January 29, 2026 19:25
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

Removes a redundant documentation file for authoring azd commands so there is a single, comprehensive source of guidance (new-azd-command.md).

Changes:

  • Deleted cli/azd/docs/style-guidelines/adding-command.md (older, subset documentation).
  • Confirmed there are no remaining references to adding-command.md in the repository (searched across common doc/code/config extensions).

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@rajeshkamal5050
Copy link
Contributor

/check-enforcer override

@rajeshkamal5050 rajeshkamal5050 merged commit 3e45e71 into main Jan 30, 2026
13 checks passed
@kristenwomack kristenwomack deleted the copilot/tidy-duplicate-docs branch January 30, 2026 03:33
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.

Tidy duplicate files

4 participants