Skip to content

[workshop-sync] workshop/side-quest-enterprise-setup.md: unverifiable GHES 3.12 minimum version claim #3402

Description

@github-actions

Workshop file reviewed

workshop/side-quest-enterprise-setup.md

Problem

The file states:

Agentic workflows require GHES 3.12 or later. On earlier versions, the Copilot cloud agent feature is unavailable regardless of licensing or policy settings.

and includes a support table row citing "GitHub Enterprise Server (GHES) 3.12+" / "< 3.12" as the support boundary.

I could not find this "GHES 3.12" minimum documented anywhere in gh-aw's own reference docs (github-agentic-workflows.md, syntax-core.md, syntax-agentic.md, self-hosted-runners.md, enterprise-configuration, engines.md, faq.md). The only GHES version threshold gh-aw's docs document is unrelated: GHES 3.21.x and earlier need "GHES compatibility mode" (aw.json ghes: true or gh aw compile --ghes) so the compiler emits older upload-artifact@v3.2.2 / download-artifact@v3.1.0 actions instead of v4+, because those older GHES releases predate the @actions/artifact v2.0.0 support needed for v4+ actions.

Additionally, GitHub's currently supported GHES versions are 3.17–3.22 — version 3.12 is already end-of-life and not a meaningful "current" boundary for a workshop maintained today.

Current correct syntax / behaviour

There is no documented minimum GHES version specifically for agentic workflows / Copilot cloud agent support. The real, documented GHES-specific consideration for gh-aw is the artifact-action compatibility mode boundary (GHES 3.21.x and earlier need ghes: true in aw.json, or gh aw compile --ghes), not a general "requires GHES 3.12+" feature gate.

Suggested fix

Remove the specific "GHES 3.12 or later" claim and the corresponding support-table row/column that imply a documented minimum version. Replace with generic guidance directing learners to:

  1. Confirm with their enterprise admin whether Copilot Enterprise and agentic-workflow support (cloud agent, Actions, network egress) are enabled for their GHES instance.
  2. Confirm whether their GHES version requires gh-aw's "GHES compatibility mode" (aw.json ghes: true or gh aw compile --ghes) for artifact-action compatibility, per the Enterprise Configuration and Self-Hosted Runners reference docs — rather than citing an unverified specific version number.

Generated by 🔍 Workshop Sync Check · copilot · auto · 283.8 AIC · ⌖ 6.14 AIC · ⊞ 8.6K · ◷

  • expires on Sep 16, 2026, 11:51 AM UTC

Activity

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

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentation

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions