Docs: Add "Supported Languages & Ecosystems" reference page

[Copilot]

Users had no single place to look up which ecosystem identifier to use for their language — the information was scattered across the network reference and configuration guide.

New page: reference/supported-languages

• Language → ecosystem identifier → package manager table (Python, Node/TS, Java, Go, Rust, .NET, Ruby, PHP, Swift, Kotlin, Dart, C/C++)
• Infrastructure ecosystems table (defaults, github, containers, linux-distros) that apply across all languages
• Single-language, JVM-family, and multi-language configuration examples
• Platform note: sandbox is Ubuntu Linux; Swift requires Linux-compatible frameworks
• Pointer to reference/network#ecosystem-identifiers for less common languages (Elixir, Haskell, Julia, etc.)

Cross-linking

• reference/network.md — ecosystem identifiers paragraph now links to the new page as a "language-first overview"
• guides/network-configuration.md — added to Related Documentation
• astro.config.mjs — sidebar entry added alphabetically between "Schedule Syntax" and "Templating"

[github-actions]

Hey @Copilot 👋 — great initiative adding a "Supported Languages & Ecosystems" reference page! Consolidating the ecosystem identifier table into one language-first view addresses a real discoverability gap — right now readers have to hunt across the network reference and the configuration guide to piece that together.

A few things to tighten up before this moves out of draft:

• No CI runs recorded — the PR has zero check runs, so the Astro/docs site build hasn't been validated yet. The astro.config.mjs sidebar entry and the new reference/supported-languages.md page both need to survive a full docs build to catch broken links or frontmatter issues.
• Draft status — mark ready-for-review once the build passes and you're happy with the content.
• Minor content gap — the new page doesn't mention deletions (from the diff, only +91/-1): it would be worth a quick pass to confirm the "Less Common Languages" section's pointer to /gh-aw/reference/network/#ecosystem-identifiers resolves correctly in the built site.

If you'd like a hand addressing the build-verification gap, here's a prompt you can run with your agent:

Validate the Astro docs site build for PR branch `copilot/add-supported-languages-page` in `github/gh-aw`.

Steps:
1. From the `docs/` directory, run the Astro build (`npm run build` or equivalent) and confirm it exits 0.
2. Search the build output for broken-link warnings referencing `/reference/supported-languages/` or `#ecosystem-identifiers` and fix any that appear.
3. Confirm the sidebar entry added to `docs/astro.config.mjs` (label "Supported Languages", link "/reference/supported-languages/") appears in the generated nav.
4. If the build fails for any reason, fix the root cause (e.g. missing frontmatter fields, invalid MDX syntax, bad anchor targets) and re-run until clean.
5. Once the build is green, mark the PR as ready for review.

Generated by Contribution Check · ◷

[Copilot]

Pull request overview

Adds a consolidated reference page that maps common programming languages to the correct network.allowed ecosystem identifiers, and cross-links it from existing network documentation/navigation.

Changes:

• Added new reference page reference/supported-languages with language → ecosystem → package manager tables and configuration examples.
• Updated reference/network and guides/network-configuration to cross-link the new page.
• Added the new page to the docs sidebar navigation.

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated 2 comments.

File	Description
docs/src/content/docs/reference/supported-languages.md	New language-first ecosystem identifier reference page with examples.
docs/src/content/docs/reference/network.md	Adds a link to the new “Supported Languages” page from the ecosystem identifiers section.
docs/src/content/docs/guides/network-configuration.md	Adds the new page to “Related Documentation”.
docs/astro.config.mjs	Adds sidebar entry for the new reference page.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

defaults is described as “Required by all workflows” and as providing the C/C++ toolchain. In practice, workflows can intentionally omit defaults (or even set network.allowed: [] to deny all), and toolchain availability is independent of the network allowlist. Suggest rewording this row to reflect that defaults is the default baseline when network isn’t specified (and/or recommended), and removing/moving the toolchain claim to the Sandbox page if needed.

[Copilot]

This section says the Network Permissions page contains the “complete list” of ecosystem identifiers, but the reference/network table currently doesn’t include several identifiers mentioned here (e.g., kotlin, elixir, ocaml). Either expand the Network Permissions table to truly be complete, or adjust this sentence to avoid claiming completeness and instead link to an authoritative source for the full list.

Suggested change

	Additional language ecosystems are available for less common languages including Elixir, Haskell, Julia, Perl, OCaml, Deno, and Terraform. See the full [Ecosystem Identifiers table](/gh-aw/reference/network/#ecosystem-identifiers) in the Network Permissions reference for the complete list.
	## Related Documentation
	- [Network Permissions](/gh-aw/reference/network/) — Complete network configuration reference including all ecosystem identifiers
	Additional language ecosystems are available for less common languages including Elixir, Haskell, Julia, Perl, OCaml, Deno, and Terraform. See the [Ecosystem Identifiers table](/gh-aw/reference/network/#ecosystem-identifiers) in the Network Permissions reference for the most up-to-date list of supported identifiers.
	## Related Documentation
	- [Network Permissions](/gh-aw/reference/network/) — Network configuration reference and ecosystem identifiers table

[pelikhan]

@copilot review comments

[Copilot]

@copilot review comments

Addressed both reviewer comments in 7800088:

1. defaults row — removed "Required by all workflows" and the toolchain claim. Now reads: "This is the default when network: is not specified, and is recommended as the starting baseline for most workflows."

2. "complete list" claim — replaced with "most up-to-date list of supported identifiers" to avoid overclaiming completeness, and simplified the Related Documentation entry for Network Permissions to match the reviewer's suggestion.