[docs] Update documentation for features from 2026-05-13#31928
Conversation
…rtifact-compat feature flag Add reference documentation for three user-facing surfaces merged in the last 24h that had no prior documentation: - firewall.effective-token-steering (#31796): budget-warning system message injection via AWF v0.25.44+ - concurrency.queue and features.group-concurrency-queue (#31764): queue:max behavior and opt-out for compiler-generated groups - features.ghes-artifact-compat (#31664): per-workflow GHES artifact compatibility opt-in via frontmatter or GH_AW_FEATURES env var Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
|
Hey team 👋 — thanks for this automated documentation sweep covering One mechanical flag from the checklist:
If you would like to address that proactively, here's a ready-to-use prompt: Otherwise this looks ready for a quick maintainer review. 🤖
|
| #### Enable per workflow via `features` | ||
|
|
||
| Set `features.ghes-artifact-compat: true` in workflow frontmatter to opt a single workflow into artifact-compat mode without changing the repository-wide setting: | ||
|
|
||
| ```aw wrap | ||
| features: | ||
| ghes-artifact-compat: true | ||
| ``` | ||
|
|
||
| Equivalently, set the `GH_AW_FEATURES=ghes-artifact-compat` environment variable when invoking `gh aw compile`. When the flag is active the compiler pins `actions/upload-artifact@v3.2.2` and `actions/download-artifact@v3.1.0`; compilation fails fast if the required v3 pin is missing rather than silently emitting an incompatible v4+ reference. |
There was a problem hiding this comment.
Added a tip note pointing readers to the --ghes CLI flag and ghes: true in aw.json as the broader alternatives for repository-wide coverage. Done in the latest commit.
…section Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
| ghes-artifact-compat: true | ||
| ``` | ||
|
|
||
| Equivalently, set the `GH_AW_FEATURES=ghes-artifact-compat` environment variable when invoking `gh aw compile`. When the flag is active the compiler pins `actions/upload-artifact@v3.2.2` and `actions/download-artifact@v3.1.0`; compilation fails fast if the required v3 pin is missing rather than silently emitting an incompatible v4+ reference. |
There was a problem hiding this comment.
Removed the entire features.ghes-artifact-compat per-workflow frontmatter section and the GH_AW_FEATURES env var content — the file is back to its pre-PR state for that page.
…ure does not exist) Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
Documentation Updates - 2026-05-13
This PR updates the documentation based on user-facing features merged in the last 24 hours.
Features Documented
firewall.effective-token-steeringbudget-warning injection (from Bump AWF to v0.25.44 and addfirewall.effective-token-steeringcompiler support #31796)concurrency.queueandfeatures.group-concurrency-queueopt-out (from Addconcurrency.queuesupport and queue-aware conclusion job defaults #31764)features.ghes-artifact-compatper-workflow frontmatter opt-in andGH_AW_FEATURESenv var (from feat: add GHES-compatible artifact action versions via feature flag #31664)Detailed Changes and References
Changes Made
docs/src/content/docs/reference/network.md: added an Effective Token Steering subsection under firewall configuration documentingfirewall.effective-token-steering: true, the warning thresholds (80/90/95/99%), and the AWFv0.25.44version gate.docs/src/content/docs/reference/concurrency.md: added a Queue Behavior section explainingsinglevsmax, documented that compiler-generated groups emitqueue: maxby default, and described thefeatures.group-concurrency-queue: falseopt-out. Updated the Conclusion Job Concurrency example to show the generatedqueue: maxfield.docs/src/content/docs/reference/enterprise-configuration.md: added an Enable per workflow viafeaturessubsection coveringfeatures.ghes-artifact-compat: truefrontmatter and theGH_AW_FEATURES=ghes-artifact-compatenv var alternative, plus the fail-fast behavior when v3 artifact pins are missing.Merged PRs Referenced
firewall.effective-token-steeringcompiler support #31796 - Bump AWF to v0.25.44 and addfirewall.effective-token-steeringcompiler supportconcurrency.queuesupport and queue-aware conclusion job defaults #31764 - Addconcurrency.queuesupport and queue-aware conclusion job defaultsSkipped Issues
None - the open documentation-labeled issues in this repository are bot-generated activity reports (skill optimizer, glossary scan, spdd), not unaddressed documentation gaps.
Notes
frontmatter-full.mdis auto-generated from the JSON schema and was not edited;concurrency.queuewill appear there on the next schema regeneration.on.skip-author-associationsAddon.skip-author-associationspre-activation gating byauthor_association#31836,pre-agent-steps/post-stepsallowlist Docs/tests: includepre-agent-stepsandpost-stepsin shared import allowlist #31912,gh aw fixcodemods Add defaultgh aw fixcodemod to lowercase discussion trigger categories in frontmatter #31872 and Addgh aw fixcodemod to rewrite single-quotedtools.bashargs safely #31874,gh awfirst-class runtime Treatgh awas a first-class runtime with releasesetup-cliinjection, dev source build, and firewall domains #31622, npm/pip validation messages Clarify npm and pip package name validation errors #31822, strict-mode opt-out Align strict-mode compatibility: allow Playwright MCP warnings and honor workflow-level strict opt-out for pull_request_target #31914, top-levelcommandrejection Reject unused top-levelcommandin main workflow frontmatter schema #31750) were verified against existing docs and already have coverage intriggers.md,command-triggers.md,frontmatter.md,maintaining-repos.md,imports.md, and the CLI/troubleshooting pages.