Skip to content

Commit c5b3ee5

Browse files
committed
added an Optional - Build a Backer Concierge AI Agent lesson for the CLI workshop
1 parent 7ddcf24 commit c5b3ee5

20 files changed

Lines changed: 466 additions & 13 deletions

.github/instructions/astro.instructions.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -20,4 +20,4 @@ This is a docs wrapper. Don't add interactive framework islands (Svelte, React,
2020

2121
## Building and verifying
2222

23-
After changing `astro.config.mjs` or anything under `website/src/`, build and verify the site with the [`build-and-verify-docs`](../skills/build-and-verify-docs/SKILL.md) skill. Its page-count invariant is the tripwire for unexpected routed pages: Starlight emits each of the 36 workshop routes for the root language and five configured locales, then adds the legacy redirect, for 217 built `index.html` pages excluding the 404 page. If the count changes without a corresponding route or locale change, check the locale layout under `docs/` and the underscore-directory exclude in `src/content.config.ts`.
23+
After changing `astro.config.mjs` or anything under `website/src/`, build and verify the site with the [`build-and-verify-docs`](../skills/build-and-verify-docs/SKILL.md) skill. Its page-count invariant is the tripwire for unexpected routed pages: Starlight emits each of the 37 workshop routes for the root language and five configured locales, then adds the legacy redirect, for 223 built `index.html` pages excluding the 404 page. If the count changes without a corresponding route or locale change, check the locale layout under `docs/` and the underscore-directory exclude in `src/content.config.ts`.

.github/pull_request_template.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@
1616

1717
<!-- Confirm the build + link checks pass before requesting review. -->
1818

19-
- [ ] `cd website && rm -rf dist && npm run build` succeeds (target: 36 routes × 6 locales + 1 redirect = 217 built pages excluding 404; build reports 218 HTML files including 404, or note any intentional change)
19+
- [ ] `cd website && rm -rf dist && npm run build` succeeds (target: 37 routes × 6 locales + 1 redirect = 223 built pages excluding 404; build reports 224 HTML files including 404, or note any intentional change)
2020
- [ ] Lychee link check passes:
2121
`mkdir -p /tmp/lychee-root && ln -sfn $PWD/website/dist /tmp/lychee-root/copilot-workshops && lychee --offline --no-progress --root-dir /tmp/lychee-root 'website/dist/**/*.html'`
2222
- [ ] External GitHub URLs that I changed have been clicked manually (lychee runs offline)

.github/skills/build-and-verify-docs/SKILL.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -43,7 +43,7 @@ cd website && rm -rf dist && npm run build
4343

4444
### 2. Page-count invariant
4545

46-
The workshop has 36 distinct route slugs. Starlight emits each route for the English root locale and the five configured localized routes, using English fallback content when a translation is unavailable. The built site therefore contains $36 \times 6 = 216$ workshop routes plus the one legacy redirect (`/shared/0-prereqs/`, authored as a full-HTML redirect page at `website/src/pages/shared/0-prereqs.astro`). The expected count is 217 `index.html` files when excluding the 404 page. Astro reports 218 HTML files because it includes the 404 page.
46+
The workshop has 37 distinct route slugs. Starlight emits each route for the English root locale and the five configured localized routes, using English fallback content when a translation is unavailable. The built site therefore contains $37 \times 6 = 222$ workshop routes plus the one legacy redirect (`/shared/0-prereqs/`, authored as a full-HTML redirect page at `website/src/pages/shared/0-prereqs.astro`). The expected count is 223 `index.html` files when excluding the 404 page. Astro reports 224 HTML files because it includes the 404 page.
4747

4848
```bash
4949
# distinct route slugs in the English root locale (docs/README.md + docs/<harness>/*.md)
@@ -61,7 +61,7 @@ find website/dist -name index.html | grep -v 404 | wc -l
6161

6262
### 2b. Translations actually render (not silent English fallback)
6363

64-
The build and the page-count above are **blind to which content actually renders** — a mis-nested or wrongly-identified locale tree still emits 217 pages served from English fallback. Assert that a known translated page carries translated text and the right `lang` attribute:
64+
The build and the page-count above are **blind to which content actually renders** — a mis-nested or wrongly-identified locale tree still emits 223 pages served from English fallback. Assert that a known translated page carries translated text and the right `lang` attribute:
6565

6666
```bash
6767
grep -o '<title>[^<]*</title>' website/dist/es-es/app/2-add-star-rating/index.html # Spanish title

AUTHORING.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -113,7 +113,7 @@ The site runs at <http://localhost:4321/copilot-workshops/>.
113113
**Verify** before committing:
114114

115115
1. **Build**`cd website && rm -rf dist && npm run build`. Must succeed.
116-
2. **Page-count invariant** — Starlight emits 36 workshop routes for English and each of the five configured locales, then adds the legacy redirect. This equals 217 built `index.html` pages when excluding the 404 page; the build reports 218 HTML files including the 404 page.
116+
2. **Page-count invariant** — Starlight emits 37 workshop routes for English and each of the five configured locales, then adds the legacy redirect. This equals 223 built `index.html` pages when excluding the 404 page; the build reports 224 HTML files including the 404 page.
117117
3. **Link check** — lychee (offline) against the built `website/dist/`. Catches broken internal links/images.
118118

119119
**What CI enforces vs. what you run locally:** CI (`pages.yml`) runs the **build** and the **lychee** link check on every PR. It does not run browser validation or the content-alignment agentic workflow as part of the Pages build job. After merge to `main`, `pages.yml` deploys the site to GitHub Pages.
245 KB
Loading
487 KB
Loading
180 KB
Loading
225 KB
Loading
371 KB
Loading
234 KB
Loading

0 commit comments

Comments
 (0)