Skip to content

Update integrate-boards command help text to clarify ADO PAT 'All organizations' requirement #1352

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.

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

Draft
wants to merge 3 commits into
base: main
Choose a base branch
from

Conversation

Copilot
Copy link

@Copilot Copilot AI commented Jun 7, 2025

The ado2gh integrate-boards command requires an ADO Personal Access Token (PAT) with "All organizations" access selected, but this requirement was not clearly documented in the command's help text. This led to user confusion and NullReferenceExceptions when users attempted to run the command with PATs that only had access to specific organizations.

Changes Made

Updated the help text for the integrate-boards command to include a clear note about the ADO PAT requirement:

The ADO_PAT token must have 'All organizations' access selected.

This change ensures users understand the specific permission requirements before attempting to use the command.

Verification

  • All existing tests continue to pass (5/5 IntegrateBoards tests)
  • Help text displays correctly with the new requirement when running ado2gh integrate-boards --help
  • Build succeeds without any warnings or errors
  • Change is minimal and surgical (3 lines added, 1 modified)

Fixes #1252.

Warning

Firewall rules blocked me from connecting to one or more addresses

I tried to connect to the following addresses, but was blocked by firewall rules:

  • http://www.microsoft.com:80/pkiops/crl/Microsoft%20Identity%20Verification%20Root%20Certificate%20Authority%202020.crl
    • Triggering command: dotnet build (http block)
  • http://www.microsoft.com:80/pkiops/crl/Microsoft%20Public%20RSA%20Timestamping%20CA%202020.crl
    • Triggering command: dotnet build (http block)
  • www.githubstatus.com
    • Triggering command: ./ado2gh integrate-boards --help (dns block)

If you need me to access, download, or install something from one of these locations, you can either:


💡 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 and others added 2 commits June 7, 2025 04:30
@Copilot Copilot AI changed the title [WIP] Make integrate-boards command help text more clear Update integrate-boards command help text to clarify ADO PAT 'All organizations' requirement Jun 7, 2025
@Copilot Copilot AI requested a review from dylan-smith June 7, 2025 04:33
Copilot finished work on behalf of dylan-smith June 7, 2025 04: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.

Make integrate-boards command help text more clear
2 participants