Skip to content

[docs] Update documentation for features from 2026-11-11 - #76835

Merged
github-actions[bot] merged 1 commit into
mainfrom
docs/daily-updates-2026-11-11-13df91a787c82099
Nov 11, 2026
Merged

github-actions[bot] merged 1 commit into
mainfrom
docs/daily-updates-2026-11-11-13df91a787c82099

Conversation

@github-actions

Copy link
Copy Markdown
Contributor

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

Detailed changes and references

Changes Made

  • docs/src/content/docs/setup/cli.md: add gh aw connector <id> setup|test and 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

Validation and Notes

  • Passed: git diff --check; checks for documentation frontmatter presence, balanced code fences, and added link targets/anchors.
  • make test-unit completed successfully and reported no changed Go files to test.
  • Required make agent-report-progress was attempted and stopped when downloading Go 1.27.4 failed certificate verification.
  • npm --prefix docs run build passed the reading-measure precheck, then failed because Astro was unavailable. Installing locked docs dependencies with npm ci failed certificate verification. Full gate and site-build validation remain incomplete; this PR is a draft. Certificate checks were preserved.
  • Generated documentation changes from prebuild were restored; the commit contains only the three intended pages. No new YAML workflow examples require compilation.
  • Five merged PR results, two open documentation issues, and twelve recently closed documentation issues were withheld by the integrity policy, limiting scan coverage.
  • The requested .github/instructions/documentation.instructions.md is absent; the repository documentation skill supplied the Diátaxis/Starlight guidance.
  • Steering issue [aw] Daily Documentation Updater: reported incomplete result #76833 had no comments on the final check.

Next Actions

Run the full validation gate and Astro build in an environment with working dependency certificate trust, then review the draft documentation changes.

Generated by 📝 Daily Documentation Updater · codex · routed: gpt61 high · ~103 AIC · ⌖ ~2 AIC · ⊞ 639 · ◷

  • expires on Nov 12, 2026, 2:50 AM UTC-08:00

@github-actions github-actions Bot added automation documentation Improvements or additions to documentation labels Nov 11, 2026
Copilot AI dynamic review requested due to automatic review settings November 11, 2026 10:50
@github-actions
github-actions Bot enabled auto-merge (squash) November 11, 2026 10:50
@github-actions
github-actions Bot merged commit 7cf8df4 into main Nov 11, 2026
2 checks passed

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟡 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 from gh aw connectors.
  • Updates Jira, Linear, and Azure DevOps glossary terminology for declarative connectors.
  • Documents windows-latest WSL2 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.
@github-actions

Copy link
Copy Markdown
Contributor Author

🎉 This pull request is included in a new release.

Release: v1.2.3

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

automation documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant