Skip to content

[docs-linker] workshop docs: add gh-aw doc links#1728

Merged
pelikhan merged 2 commits into
mainfrom
docs-linker/add-gh-aw-doc-links-batch2-45984a33f72f5f7c
Jul 21, 2026
Merged

[docs-linker] workshop docs: add gh-aw doc links#1728
pelikhan merged 2 commits into
mainfrom
docs-linker/add-gh-aw-doc-links-batch2-45984a33f72f5f7c

Conversation

@github-actions

Copy link
Copy Markdown
Contributor

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

workshop/06-install-gh-aw.md

workshop/06a-install-terminal.md

workshop/06b-install-local.md

workshop/04-github-actions-intro.md


Automated by the docs-linker workflow.

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.allowed list in your workflow frontmatter:

network:
  allowed:
    - defaults
    - "awmgmcpg"

See Network Configuration for more information.

Generated by 🔗 Docs Linker · 141.4 AIC · ⌖ 6.58 AIC · ⊞ 6.8K ·

  • expires on Jul 22, 2026, 7:40 AM UTC

- 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>
@github-actions github-actions Bot added docs-linker documentation Improvements or additions to documentation labels Jul 21, 2026
@pelikhan
pelikhan merged commit bd2134b into main Jul 21, 2026
4 checks passed
@pelikhan
pelikhan deleted the docs-linker/add-gh-aw-doc-links-batch2-45984a33f72f5f7c branch July 21, 2026 07:44

@github-actions github-actions Bot left a comment

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

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.allowed list 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 `&lt;!-- learning: false --&gt;` annotation on line 3. This annotation is not part of the defined page annotation schema in the guidelines, which only specifies `&lt;!-- page-journey: &lt;value&gt; --&gt;` and `&lt;!-- page-adventure: &lt;value&gt; --&gt;` as the required first two lines.

**Offending text:**

<!-- learning: false -->


**Suggested fix:**
Remove the `&lt;!-- learning: false --&gt;` 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 `&lt;details&gt;` wrapper for multi-line callouts as specified by the guidelines.

Compare with `06b-install-local.md` which correctly wraps the same content in `&lt;details&gt;`:

```markdown
&lt;details&gt;
&lt;summ…

</details>

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

Labels

docs-linker documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant