[workshop-sync] workshop/18-share-and-reuse.md: `gh aw add` shorthand lookup location unclear
Maintainers usually reply within 3 days
Nobody has claimed this yet.
Assessment
- Difficulty
- 2/5
- Estimated time
- 1-3 hours
- Newbie friendliness
- 62/100
- Issue type
- Documentation
- Clarity
- Mostly clear
- Activity status
- Active
- Tech stack
- github, github-actions, markdown
- Domain
- documentation
Research direction
The claim is on line 20 of workshop/18-share-and-reuse.md, and the example on line 76 uses the three-part gh aw add form. Run gh aw add --help and test whether .github/workflows/ resolves as a shorthand location before editing. Done when the page either names the directory the shorthand actually searches or shows the explicit four-part path or blob URL for .github/workflows/ files.
Written by the indexing model from the issue text.
Description
Workshop file reviewed
workshop/18-share-and-reuse.md
Problem
Line 20 says:
Any
.mdfile in a.github/workflows/folder of a repository you have read access to can act as a template
and line 76 shows gh aw add jsmith/my-workshop/daily-status.
The live gh aw add help (gh-aw v1.0.1) says the three-part form is owner/repo/workflow-name[@version] and "implicitly looks in workflows/ directory". It doesn't mention .github/workflows/ as the shorthand lookup location, so the page's claim is not supported by the CLI help.
Suggested fix
Clarify where the shorthand resolves. Either say the template should live in workflows/ for the shorthand to work, or show the explicit four-part form (owner/repo/workflows/workflow-name.md[@version]) or a full GitHub blob URL for files in .github/workflows/. Verify the actual behavior with gh aw add --help and a test before editing.
Files 19 (19-research-driven-training-node.md) and 20 (20-persistent-memory.md) were also reviewed with no issues found. Two external links (reusing-workflows, compilation-process) could not be checked against the doc URL map.
Generated by 🔍 Workshop Sync Check · copilot · auto · ~54 AIC · ⌖ ~1 AIC · ⊞ 4.7K · ◷
- expires on Nov 3, 2026, 11:28 AM UTC
- Dominant language
- JavaScript
- Stars
- 58
- Forks
- 40
- Avg merge
- 4d 4h
- Merged PRs (30d)
- 8
Getting set up
Starts the project's dev container in your browser, under your own GitHub account.
- No Dockerfile or Docker Compose file
- No pull request template
- No contributing guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from githubnext/gh-aw-workshop
-
[ordering-review] workshop order graph: 1 confirmed ordering problem, 3 cycles are false positivesOpen
Difficulty 2/5 1-3 hours Newbie friendliness 85/100
githubnext/gh-aw-workshop#5331 ·
Maintainers usually reply within 3 days
-
feedback simulation workshop
Difficulty 2/5 1-3 hours Newbie friendliness 69/100
githubnext/gh-aw-workshop#5328 ·
Maintainers usually reply within 3 days
-
[curriculum-eval] 04-github-actions-intro.md: cognitive_load — 28 new concepts in a "5 minutes" pageOpencurriculum documentation quality
Difficulty 2/5 1-3 hours Newbie friendliness 77/100
githubnext/gh-aw-workshop#5320 ·
Maintainers usually reply within 3 days
-
curriculum documentation quality
Difficulty 2/5 1-3 hours Newbie friendliness 74/100
githubnext/gh-aw-workshop#5321 ·
Maintainers usually reply within 3 days
-
[ordering-review] workshop order graph: environment reference verifies tools before Codespace existsOpen
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
githubnext/gh-aw-workshop#5313 ·
Maintainers usually reply within 3 days
All issues in githubnext/gh-aw-workshop
Similar issues
-
clientV2: Application Info header separators show as missing-character boxes without a CJK fontOpenbug new-client
Difficulty 1/5 1-3 hours Newbie friendliness 88/100
NUWCDIVNPT/stig-manager#2285 ·
Maintainers usually reply within 1 day
-
Difficulty 1/5 Under an hour Newbie friendliness 88/100
Fei2411/DeepSeek-Bot#922 · 1 reaction ·
-
server errored
Difficulty 2/5 1-3 hours Newbie friendliness 75/100
OpenTermsArchive/contrib-declarations#4273 ·
Maintainers usually reply within 1 day
-
needs-area-label
Difficulty 2/5 1-3 hours Newbie friendliness 66/100
Maintainers usually reply within 2 days
-
serienstream.toOpenN: AdGuard for Windows P2: High T: Annoyance
Difficulty 2/5 1-3 hours Newbie friendliness 61/100
AdguardTeam/AdguardFilters#246310 ·
Maintainers usually reply within 1 day