Skip to content

Fix broken workshop links and restore the missing browser-path Step 6c page#1842

Merged
pelikhan merged 5 commits into
mainfrom
copilot/workshop-link-checker-fix-broken-links
Jul 22, 2026
Merged

Fix broken workshop links and restore the missing browser-path Step 6c page#1842
pelikhan merged 5 commits into
mainfrom
copilot/workshop-link-checker-fix-broken-links

Conversation

Copilot AI commented Jul 22, 2026

Copy link
Copy Markdown
Contributor

The workshop link checker reported four broken links across the curriculum: one missing internal step file and three external links pointing to auth-gated or non-existent targets. This update restores the missing browser-path step and replaces unstable external links with resolvable public references.

  • Restore the missing curriculum target

    • Added workshop/06c-install-ui.md as the browser-path Step 6c page referenced from workshop/README.md
    • Updated browser-path navigation so Step 6 now lands on the new “No Installation Needed” page before continuing to the Copilot authoring flow
  • Remove auth-gated GitHub URLs from learner docs

    • Replaced the direct github.com/signup link in workshop/01-prerequisites.md with guidance to use the sign-up flow from github.com
    • Removed the private github.com/settings/billing link from workshop/02a-setup-codespace.md and replaced it with neutral plan/admin guidance
  • Point gh-aw docs at a concrete public page

    • Replaced the broken docs index link in workshop/05-agentic-workflows-intro.md from /gh-aw/patterns/ to /gh-aw/patterns/issue-ops/
  • Keep the browser path internally consistent

    • Updated workshop/02c-setup-browser.md and workshop/06-install-gh-aw.md so the UI journey explicitly routes through Step 6c instead of skipping to Step 7
- > Struggling to think of a task? Browse the [gh-aw patterns](https://github.github.com/gh-aw/patterns/) for inspiration.
+ > Struggling to think of a task? Browse the [gh-aw issue-ops pattern](https://github.github.com/gh-aw/patterns/issue-ops/) for inspiration.

Copilot AI linked an issue Jul 22, 2026 that may be closed by this pull request
Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
Copilot AI changed the title [WIP] Fix broken links in workshop files Fix broken workshop links and restore the missing browser-path Step 6c page Jul 22, 2026
Copilot AI requested a review from pelikhan July 22, 2026 11:17
@pelikhan

Copy link
Copy Markdown
Contributor

@copilot install ui must reference the prompt in https://github.github.com/gh-aw/setup/creating-workflows/#initialize-the-repository to initialize the repo using CCA

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

Copilot AI commented Jul 22, 2026

Copy link
Copy Markdown
Contributor Author

@copilot install ui must reference the prompt in https://github.github.com/gh-aw/setup/creating-workflows/#initialize-the-repository to initialize the repo using CCA

Addressed in 01914d7. Step 6c now includes the GitHub Copilot repository-initialization prompt for the browser path, and Step 7c now assumes that initialization PR has already been merged before workflow creation.

Comment thread workshop/06c-install-ui.md Outdated
**GitHub Copilot app — paste this prompt:**

```text
Using the agentic-workflows skill, initialize this repository for GitHub Agentic Workflows using https://raw.githubusercontent.com/github/gh-aw/main/install.md

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.

@copilot the agentic-workflows skill is not installed YET so do not tell the user to use to install th etooling.

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.

Fixed in 9716124. The browser-path initialization step now uses the plain repository-initialization prompt and no longer tells learners to invoke the agentic-workflows skill before it has been installed.

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
Copilot AI requested a review from pelikhan July 22, 2026 11:33
@pelikhan
pelikhan marked this pull request as ready for review July 22, 2026 11:35
@pelikhan
pelikhan merged commit 8c106e6 into main Jul 22, 2026
4 checks passed
@pelikhan
pelikhan deleted the copilot/workshop-link-checker-fix-broken-links branch July 22, 2026 11:35

@github-actions github-actions Bot 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.

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 #1842 · 39.4 AIC · ⌖ 7.86 AIC · ⊞ 5.7K

Comments that could not be inline-anchored

workshop/02a-setup-codespace.md:17

Rule violated: Alert level ceiling (guidelines: Alert callouts section)

Offending text:

&gt; [!IMPORTANT]
&gt; **On a phone?** Creating a repository works in any browser, but the Codespace terminal requires a tablet or laptop...

Suggested fix: Downgrade to [!TIP]. Device compatibility guidance is helpful context — not information the learner must act on before continuing safely. The guidelines reserve [!IMPORTANT] for that threshold; regular advisory content should use `…

workshop/07c-your-first-workflow-copilot.md:24

Rule violated: Alert level ceiling (guidelines: Alert callouts section)

Offending text:

&gt; [!IMPORTANT]
&gt; **Agents tab:** You must start your message with `/agentic-workflows` to invoke the skill...

Suggested fix: Downgrade to [!NOTE]. Forgetting the prefix results in a suboptimal agent session, not a safety or data-loss issue. The guidelines reserve [!IMPORTANT] for information the learner must act on before continuing safely (e.g., actions that could expose creden…

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

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[workshop-link-checker] Broken links found

2 participants