ReviewOS

also looking at this

stacks/buddy

feat(cli): restore the affordances the docs promised

#1402
Merged glennmichael123 wants to merge feat/restore-documented-affordances into main
6 files +150 -8
docs/cli/utility.mdmodified+10-1
Changes to docs/cli/utility.md
@@ -12,12 +12,15 @@ buddy open-settings [options]
1212
1313### Description
1414
15Quickly open the GitHub settings pages needed to configure permissions for buddy. It opens the repository's Actions settings, follows with the organization's, and prints the exact options to change on each.
15Quickly open the GitHub settings pages needed to configure permissions for buddy. By default it opens the repository's Actions settings, follows with the organization's, and prints the exact options to change on each.
16
17Organization settings do not exist for a repository owned by a personal account, so `--type repo` is the quieter choice there.
1618
1719### Options
1820
1921| Option | Description | Default |
2022|--------|-------------|---------|
23| `--type <scope>` | Which settings to open: `repo`, `org` or `both` | `both` |
2124| `--verbose, -v` | Enable verbose logging | `false` |
2225
2326### Examples
@@ -26,6 +29,12 @@ Quickly open the GitHub settings pages needed to configure permissions for buddy
2629# Open the Actions settings pages for this repository
2730buddy open-settings
2831
32# Only this repository's settings, skipping the organization
33buddy open-settings --type repo
34
35# Only the organization's, when repository permissions are already correct
36buddy open-settings --type org
37
2938# Show how the repository was resolved
3039buddy open-settings --verbose
3140```