Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .github/workflows/copilot-workshops-sync.lock.yml

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

13 changes: 7 additions & 6 deletions .github/workflows/copilot-workshops-sync.md
Original file line number Diff line number Diff line change
Expand Up @@ -97,8 +97,8 @@ Localized pages share the English images: keep their image references pointing a

Navigation is wired in three places:

- `website/astro.config.mjs` — the sidebar group **"Copilot Workshops"**, with a nested sub-group per harness. Starlight applies one sidebar across all locales and auto-prefixes links for the active locale, so you only configure the English (root) slugs here.
- `website/src/content/docs/learning-hub/index.md` — a short entry linking to the workshop.
- `website/astro.config.mjs` — the top-level sidebar group **"Workshops"**, with a nested sub-group per harness. Starlight applies one sidebar across all locales and auto-prefixes links for the active locale, so you only configure the English (root) slugs here.
- `website/src/content/docs/learning-hub/index.md` — a short **"Workshops"** section linking to the workshop overview and harnesses.
- `website/src/content/docs/learning-hub/copilot-workshops/index.md` — the mirrored landing page whose harness/lesson tables link to the local pages.

## Step 1 — Determine what's new upstream
Expand Down Expand Up @@ -173,14 +173,15 @@ Edit the local docs, assets, and navigation so the website remains a **source-fa

3. If upstream adds, removes, or renames harnesses or lessons:
- Create, delete, or rename the corresponding markdown files under `website/src/content/docs/learning-hub/copilot-workshops/<harness>/` (and the localized equivalents under `website/src/content/docs/<locale>/learning-hub/copilot-workshops/<harness>/`).
- Update the **"Copilot Workshops"** sidebar group in `website/astro.config.mjs` so its nested per-harness sub-groups list the Overview link plus each lesson in upstream order, using the upstream lesson titles as labels.
- Update the top-level **"Workshops"** sidebar group in `website/astro.config.mjs` so its nested per-harness sub-groups list the Overview link plus each lesson in upstream order, using the upstream lesson titles as labels.
- Update `website/src/content/docs/learning-hub/copilot-workshops/index.md` and any harness `index.md` lesson tables to match.
- Update the `website/src/content/docs/learning-hub/index.md` entry only if the workshop's landing description or link must change.
- Update the **"Workshops"** section in `website/src/content/docs/learning-hub/index.md` only if the workshop's landing description or links must change.

### Navigation wiring details

- In `website/astro.config.mjs`, add or maintain a top-level sidebar group labelled `"Copilot Workshops"`. Give it an `items` array containing one nested group per harness (labels: `VS Code`, `Copilot CLI`, `Copilot App`, `Copilot Cloud Agent`). Each nested group should start with an `Overview` entry that links to `/learning-hub/copilot-workshops/<harness>/` and then list each lesson slug (e.g. `learning-hub/copilot-workshops/app/0-prerequisites`). Follow the exact style already used by the existing `"Copilot CLI for Beginners"` group.
- Place the new group in a sensible position relative to the existing Learning Hub groups (after `"Copilot CLI for Beginners"` is a natural fit).
- In `website/astro.config.mjs`, add or maintain a **top-level** sidebar group labelled `"Workshops"`. Give it an `items` array containing one nested group per harness (labels: `VS Code`, `Copilot CLI`, `Copilot App`, `Copilot Cloud Agent`). Each nested group should start with an `Overview` entry that links to `/learning-hub/copilot-workshops/<harness>/` and then list each lesson slug (e.g. `learning-hub/copilot-workshops/app/0-prerequisites`). Follow the exact nesting style used by the existing `"Courses"` group.
- Place the `"Workshops"` group immediately **after** the `"Courses"` group and **before** the `"Videos"` group. (`astro.config.mjs` contains a placeholder comment marking exactly where it belongs.)
- In `website/src/content/docs/learning-hub/index.md`, add or maintain a `## Workshops` section (placed after `## Courses`) that briefly describes the build-along labs and links to the workshop overview page and each harness. Do not leave links that point at pages you have not created.
- Do **not** add locale-prefixed slugs to the sidebar; Starlight derives localized navigation from the single root sidebar automatically.
- Every root slug you add to the sidebar **must** correspond to a real mirrored English markdown file, or the website build will fail.

Expand Down
44 changes: 29 additions & 15 deletions website/astro.config.mjs
Original file line number Diff line number Diff line change
Expand Up @@ -130,33 +130,47 @@ export default defineConfig({
items: ["learning-hub/github-copilot-terminology-glossary"],
},
{
label: "Copilot CLI for Beginners",
label: "Courses",
items: [
{
label: "Overview",
link: "/learning-hub/cli-for-beginners/",
label: "Copilot CLI for Beginners",
items: [
{
label: "Overview",
link: "/learning-hub/cli-for-beginners/",
},
"learning-hub/cli-for-beginners/00-quick-start",
"learning-hub/cli-for-beginners/01-setup-and-first-steps",
"learning-hub/cli-for-beginners/02-context-and-conversations",
"learning-hub/cli-for-beginners/03-development-workflows",
"learning-hub/cli-for-beginners/04-agents-and-custom-instructions",
"learning-hub/cli-for-beginners/05-skills",
"learning-hub/cli-for-beginners/06-mcp-servers",
"learning-hub/cli-for-beginners/07-putting-it-all-together",
],
},
"learning-hub/cli-for-beginners/00-quick-start",
"learning-hub/cli-for-beginners/01-setup-and-first-steps",
"learning-hub/cli-for-beginners/02-context-and-conversations",
"learning-hub/cli-for-beginners/03-development-workflows",
"learning-hub/cli-for-beginners/04-agents-and-custom-instructions",
"learning-hub/cli-for-beginners/05-skills",
"learning-hub/cli-for-beginners/06-mcp-servers",
"learning-hub/cli-for-beginners/07-putting-it-all-together",
],
},
// The "Workshops" group is added by the Copilot Workshops sync workflow
// on its first run, once the mirrored harness pages exist. It is inserted
// immediately after "Courses" and before "Videos". It is intentionally not
// pre-created here: Starlight fails the build if a sidebar entry points at
// a page that does not yet exist.
{
label: "Hands-on",
label: "Videos",
items: [
{
label: "Cookbook",
link: "/learning-hub/cookbook/",
label: "Copilot CLI for Beginners",
link: "https://www.youtube.com/watch?v=BDxRhhs36ns&list=PL0lo9MOBetEHvO-spzKBAITkkTqv4RvNl",
},
],
},
{
label: "Browse Resources",
label: "Cookbook",
link: "/learning-hub/cookbook/",
},
{
label: "Resources",
items: [
{ label: "Home", link: "/" },
{ label: "Agents", link: "/agents/" },
Expand Down
17 changes: 14 additions & 3 deletions website/src/content/docs/learning-hub/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,23 +14,34 @@ New to GitHub Copilot? Start here to understand the tools available to you.

**Canvases**: Learn [Working with Canvas Extensions](working-with-canvas-extensions/) to create and evolve interactive canvases with `/create-canvas`.

**Terminal**: Looking for a guided path into GitHub Copilot from the terminal? Explore the [Copilot CLI for Beginners](cli-for-beginners/) with a text-based experience or the [YouTube video series](https://www.youtube.com/watch?v=BDxRhhs36ns&list=PL0lo9MOBetEHvO-spzKBAITkkTqv4RvNl).

## Fundamentals

Essential concepts to tailor GitHub Copilot beyond its default experience. Start with
[What are Agents, Skills, and Instructions](what-are-agents-skills-instructions/)
and work through the full track to master every customization primitive. For delegation
and orchestration patterns, continue with [Agents and Subagents](agents-and-subagents/).

## Courses

Guided, multi-lesson learning paths you can work through end to end.

**Copilot CLI for Beginners**: A guided path into GitHub Copilot from the terminal — [start the course](cli-for-beginners/) for the full text-based experience. Prefer to watch? See the [video series](https://www.youtube.com/watch?v=BDxRhhs36ns&list=PL0lo9MOBetEHvO-spzKBAITkkTqv4RvNl).

## Videos

Prefer to watch and follow along? Browse our YouTube playlists.

- [Copilot CLI for Beginners](https://www.youtube.com/watch?v=BDxRhhs36ns&list=PL0lo9MOBetEHvO-spzKBAITkkTqv4RvNl)

## Reference

Quick-lookup resources to keep handy while you work. Browse the
[GitHub Copilot Terminology Glossary](github-copilot-terminology-glossary/)
for definitions of common terms and concepts.

## Hands-on
## Cookbook

Interactive samples and recipes to learn by doing. Jump into the
[Cookbook](cookbook/) for code samples, recipes,
and examples you can use right away.

Loading