[docs-linker] workshop docs: add gh-aw doc links#1728
Conversation
- 05-agentic-workflows-intro.md: link tools, frontmatter, triggers, permissions, Lock file, Engine - 06-install-gh-aw.md: link agentic workflow, lock file - 06a-install-terminal.md: link agentic workflow - 06b-install-local.md: link agentic workflow - 04-github-actions-intro.md: link tools Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
There was a problem hiding this comment.
Warning
Firewall blocked 1 domain
The following domain was blocked by the firewall during workflow execution:
awmgmcpg
To allow these domains, add them to the
network.allowedlist in your workflow frontmatter:
network:
allowed:
- defaults
- "awmgmcpg"See Network Configuration for more information.
Generated by 📋 Guidelines Enforcer for #1728 · 45.9 AIC · ⌖ 5.57 AIC · ⊞ 5.7K
Comments that could not be inline-anchored
workshop/06-install-gh-aw.md:30
Rule violated: Checkpoint presence
Every workshop step file must end with a ## ✅ Checkpoint section containing a markdown checklist (per the workshop authoring guidelines).
Offending text:
> The file ends at line 30 with All paths converge at [Write Your First Agentic Workflow](07-your-first-workflow.md). — no checkpoint section follows.
Suggested fix:
Add a ## ✅ Checkpoint section before the final Next: link, for example:
## ✅ Checkpoint
- [ ] I have chosen…
</details>
<details><summary>workshop/06-install-gh-aw.md:3</summary>
**Rule violated: Workshop page annotation schema**
The file contains an undocumented `<!-- learning: false -->` annotation on line 3. This annotation is not part of the defined page annotation schema in the guidelines, which only specifies `<!-- page-journey: <value> -->` and `<!-- page-adventure: <value> -->` as the required first two lines.
**Offending text:**<!-- learning: false -->
**Suggested fix:**
Remove the `<!-- learning: false -->` line. Only the two defined page-level ann…
</details>
<details><summary>workshop/06a-install-terminal.md:44</summary>
**Rule violated: Alert callouts — single-line vs multi-line structure**
The troubleshooting section (lines 43–51) is written as plain headings and prose rather than using the correct alert callout pattern. More specifically, the troubleshooting block spans multiple lines but does not use the required `<details>` wrapper for multi-line callouts as specified by the guidelines.
Compare with `06b-install-local.md` which correctly wraps the same content in `<details>`:
```markdown
<details>
<summ…
</details>
Doc links added
Adds precise inline hyperlinks to the first bare occurrence of each matched gh-aw concept across 5 workshop files.
workshop/05-agentic-workflows-intro.md
tools→ reference/toolsfrontmatter→ reference/frontmattertriggers→ reference/triggerspermissions→ reference/permissionsLock file→ glossary#workflow-lock-fileEngine→ reference/enginesworkshop/06-install-gh-aw.md
agentic workflow→ introduction/overviewlock file→ glossary#workflow-lock-fileworkshop/06a-install-terminal.md
agentic workflow→ introduction/overviewworkshop/06b-install-local.md
agentic workflow→ introduction/overviewworkshop/04-github-actions-intro.md
tools→ reference/toolsAutomated by the docs-linker workflow.
Warning
Firewall blocked 1 domain
The following domain was blocked by the firewall during workflow execution:
awmgmcpgSee Network Configuration for more information.