Add governance guide for gh aw env defaults and scope inheritance#41758
Merged
Conversation
Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
Copilot created this pull request from a session on behalf of
pelikhan
June 26, 2026 17:02
View session
Updated the title and description for clarity.
Contributor
There was a problem hiding this comment.
Pull request overview
Adds a governance-focused guide to help operators roll out gh aw env (GH_AW_DEFAULT_*) defaults across enterprise/org/repo scopes, and wires it into the docs navigation and related references.
Changes:
- Added a new guide documenting
gh aw env get/update, scope inheritance, precedence, and compile-time vs runtime default resolution. - Added “Governance” to the Guides sidebar for discoverability.
- Linked the new guide from the environment variables reference page.
Show a summary per file
| File | Description |
|---|---|
| docs/src/content/docs/guides/governance.md | New governance guide describing defaults management, precedence, and rollout patterns. |
| docs/src/content/docs/reference/environment-variables.md | Adds cross-link to the governance guide in Related Documentation. |
| docs/astro.config.mjs | Adds “Governance” entry under Guides in the sidebar. |
Review details
Tip
Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
- Files reviewed: 3/3 changed files
- Comments generated: 3
- Review effort level: Low
Comment on lines
+39
to
+41
| > [!NOTE] | ||
| > Set a key to `null` (or omit it) to delete that variable | ||
| > from the selected scope during `gh aw env update`. |
Comment on lines
+131
to
+134
| - use non-zero integers for | ||
| `default_max_ai_credits`, | ||
| `default_max_daily_ai_credits`, | ||
| `default_detection_max_ai_credits` |
Comment on lines
+28
to
+29
| default_max_ai_credits: "5M" | ||
| default_max_daily_ai_credits: "15M" |
github-actions Bot
added a commit
that referenced
this pull request
Jun 29, 2026
Add two new glossary entries from weekly scan: - `gh aw env`: CLI command for managing GH_AW_DEFAULT_* variables at enterprise, org, and repo scope. Added to Development and Compilation section, based on the governance guide introduced in #41758. - `GH_AW_POLICY_*`: Runtime Policy Variables family that enforce capability gates without recompiling workflows (e.g., GH_AW_POLICY_ALLOW_CREATE_PULL_REQUEST). Added near GH_AW_DEFAULT_* in Advanced Features section, based on #41771. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
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.
This PR adds dedicated governance documentation for environment defaults in
gh-aw, focused on how to configureGH_AW_DEFAULT_*values withgh aw envand how scope inheritance works across enterprise, organization, and repository levels. It closes the gap between variable reference docs and operational rollout guidance for multi-repo governance.New guide: environment governance
docs/src/content/docs/guides/governance.md.gh aw env get/gh aw env updateworkflowsdefault_*YAML schema and deletion semantics (null)Navigation updates
docs/astro.config.mjsfor discoverability.Cross-reference improvements
reference/environment-variables.mdin Related Documentation.Representative snippet