docs(site): document --all-repos and --source flags for secrets commands#653
Draft
github-actions[bot] wants to merge 1 commit into
Draft
docs(site): document --all-repos and --source flags for secrets commands#653github-actions[bot] wants to merge 1 commit into
github-actions[bot] wants to merge 1 commit into
Conversation
Add the two opt-in project-scope discovery flags introduced in feat(secrets): #624 to the CLI reference page: - --all-repos: activates Preview-driven discovery across the entire ADO project, not just local lock files - --source <path>: filters to definitions whose ado-aw-metadata marker references the given template path Also adds a "Project-scope discovery" subsection with usage examples and updates the common-examples block with an --all-repos one-liner. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Open
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
--all-reposand--source, the two project-scope discovery flags added tosecrets set / list / deletein feat(secrets) feat(secrets): add --all-repos and --source via Pipeline Preview discovery #624. Previously, users who rotated tokens across multi-repo templates had no site-level docs to reference.Changes
site/src/content/docs/setup/cli.mdx— three targeted additions:--all-reposand--sourcebullets added tosecrets setoptions list;--definition-idsclarified as mutually exclusive with these flags--all-repos,--sourcebullets added tosecrets listandsecrets deleteoptions lists--all-reposone-linerAccuracy checks
--all-repos: confirmed insrc/secrets.rs—SetOpts.all_repos: bool(line 178),ListOpts.all_repos: bool(line 456),DeleteOpts.all_repos: bool(line 542); activatesDiscoveryScope::AllReposbranch (line 238)--source: confirmed asSetOpts.source: Option<&str>(line 182), same shape on List/Delete; passed assource_filtertoresolve_definitions_via_discovery(line 270)--definition-ids: confirmed byif definition_ids.is_none() && (all_repos || source_filter.is_some())guard (line 200)enable/disable/removenot changed: verified — these structs have noall_repos/sourcefieldsdocs/cli.mdProject-scope discovery section (lines 60–67)Validation
cd site && npm ci && npm run build— 28 pages built, all internal links validCreated by the docs-writer workflow.