Repository navigation
[docs] Update documentation for features from 2026-11-11 - #76835
Merged
github-actions[bot] merged 1 commit intoNov 11, 2026
Merged
Conversation
Contributor
There was a problem hiding this comment.
🟡 Changes recommended
The documentation contains an active wording issue that could mislead users about how runner settings apply separately to the agent and framework jobs.
1 open issue
What changed in this PR
This documentation-only PR updates reference guidance for declarative connector development, current provider terminology, and the narrowly scoped Windows WSL execution adapter.
Changes:
- Documents
gh aw connector <id> setup|test, including phases, flags, provisioning behavior, and its distinction fromgh aw connectors. - Updates Jira, Linear, and Azure DevOps glossary terminology for declarative connectors.
- Documents
windows-latestWSL2 prerequisites, host/WSL execution boundaries, path handling, and custom-job limitations.
| File | Description |
|---|---|
| docs/src/content/docs/setup/cli.md | Adds reference documentation for connector setup and testing commands, including their phases, flags, and usage boundaries. |
| docs/src/content/docs/reference/glossary.md | Defines declarative connectors and updates Jira, Linear, and Azure DevOps provider terminology. |
| docs/src/content/docs/reference/frontmatter.md | Describes the exact windows-latest WSL execution model, prerequisites, runner behavior, and limitations. |
Review effort: Lite (auto)
|
|
||
| #### Windows runner execution | ||
|
|
||
| For the literal `runs-on: windows-latest`, the compiler wraps POSIX steps in built-in framework jobs, including the agent job, with PowerShell launchers that execute Bash in Ubuntu WSL. Native Windows Actions remain on the host. Unrelated custom jobs and other Windows runner labels do not receive this adapter. |
1 of 8 tasks
Contributor
Author
|
🎉 This pull request is included in a new release. Release: |
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.

Documentation Updates - 2026-11-11
Document the new connector development commands, correct obsolete provider glossary entries, and describe the compiler's Windows WSL adapter. Three reference pages change; no workflow sources or generated locks change.
The activity scan covered 2026-11-10 10:41 UTC through 2026-11-11 10:41 UTC: 50 readable merged PR titles, five readable open documentation issues, and nine readable documentation issues closed within seven days, plus bounded cookie-labeled results. Integrity-filtered items were left unread.
Features Documented
windows-latestadapter, WSL2 prerequisites, host/WSL execution split, and custom-job limits from Run Windows agent framework jobs in WSL #76536. This describes compiler behavior without claiming universal Windows availability.Detailed changes and references
Changes Made
docs/src/content/docs/setup/cli.md: addgh aw connector <id> setup|testand distinguish the low-level plural command.docs/src/content/docs/reference/glossary.md: define declarative connectors and align provider entries with editable imports, exact grants, and phase credentials.docs/src/content/docs/reference/frontmatter.md: replace the blanket Windows rejection with the narrowly scoped WSL behavior.Verified against
pkg/cli/connector_development_command.go,connector_development_test_command.go,connectors_command.go,pkg/workflow/windows_runner.go, existing Windows rendering regressions, and current connector declarations/reference sections. The PageIndex revision matched the starting checkout; edited files were reread directly.Existing Coverage
Routing default changes (#76602), advisory safe outputs (#76711), and protected-file merge checks (#76771) already have reference documentation. #76575 addresses the four CLI defaults/side-effects findings in #76525, which are present in the checkout. Internal refactors, regression fixes, and repository-specific workflow changes did not warrant additional reference content.
AI dictionary alignment summary
Terms reviewed: MCP, declarative connector, and safe outputs. Adopted the AI Coding Dictionary's MCP definition as the generic protocol terminology. Retained repository-specific connector and safe-output semantics as the primary authority. No terminology conflicts required resolution.
Skipped Issues
reference/compliance-patterns.mdalready covers human sponsorship, independent review, and research/issue/assignment patterns.Validation and Notes
git diff --check; checks for documentation frontmatter presence, balanced code fences, and added link targets/anchors.make test-unitcompleted successfully and reported no changed Go files to test.make agent-report-progresswas attempted and stopped when downloading Go 1.27.4 failed certificate verification.npm --prefix docs run buildpassed the reading-measure precheck, then failed because Astro was unavailable. Installing locked docs dependencies withnpm cifailed certificate verification. Full gate and site-build validation remain incomplete; this PR is a draft. Certificate checks were preserved..github/instructions/documentation.instructions.mdis absent; the repository documentation skill supplied the Diátaxis/Starlight guidance.Next Actions
Run the full validation gate and Astro build in an environment with working dependency certificate trust, then review the draft documentation changes.