Skip to content

Restructure Learning Hub nav into Courses / Workshops / Videos#2379

Closed
GeekTrainer wants to merge 1 commit into
github:mainfrom
GeekTrainer:geektrainer/learning-hub-restructure
Closed

Restructure Learning Hub nav into Courses / Workshops / Videos#2379
GeekTrainer wants to merge 1 commit into
github:mainfrom
GeekTrainer:geektrainer/learning-hub-restructure

Conversation

@GeekTrainer

Copy link
Copy Markdown
Contributor

Follow-up to #2325. Now that the Copilot Workshops sync is in place, the Learning Hub nav was about to gain a fifth top-level group and ~35 more pages, and the existing structure was already doing a lot. This reworks it so the growing set of guided material stays browsable.

What changed

  • New "Courses" group — guided, multi-lesson learning paths. Moved "Copilot CLI for Beginners" under it (nested), which also gives the in-progress Copilot App course a home to land in.
  • New "Videos" group — YouTube playlists, starting with the CLI for Beginners series. Pulled the video link out of the landing-page prose so it has a consistent home.
  • "Cookbook" promoted to its own top-level entry (it was buried under "Hands-on", and it's a recipe grab-bag, not a sequential course, so it doesn't belong with the workshops).
  • "Browse Resources" → "Resources".
  • Landing page restructured to match the new taxonomy.
  • Sync workflow updated so its first run wires a top-level "Workshops" group (placed right after "Courses", before "Videos") plus a matching landing-page section.

Why the Workshops group isn't in this PR

Starlight fails the build if a sidebar entry points at a page that doesn't exist yet, and the workshop pages don't exist until the sync workflow's first import. So this PR leaves a placeholder comment marking exactly where the group goes, and the workflow creates it on first run. This PR should land before that first run so the import slots into the right structure.

The resulting top-level order is: Fundamentals, Reference, Courses, Workshops (added by the sync), Videos, Cookbook, Resources.

Reworks the Learning Hub navigation ahead of the Copilot Workshops import
so the growing set of guided material stays browsable:

- Adds a top-level "Courses" group and nests "Copilot CLI for Beginners"
  under it, leaving room for the upcoming Copilot App course.
- Adds a "Videos" group for YouTube playlists (starting with the CLI for
  Beginners series, moved out of the landing-page prose).
- Promotes "Cookbook" to its own top-level entry (out of "Hands-on").
- Renames "Browse Resources" to "Resources".
- Restructures the Learning Hub landing page to match the new taxonomy.
- Updates the Copilot Workshops sync workflow so its first run wires a
  top-level "Workshops" group (placed after "Courses", before "Videos")
  and a matching landing-page section. The empty group is intentionally
  not pre-created here, since Starlight fails the build on sidebar entries
  that point at pages that do not exist yet.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Copilot-Session: 9e1d1a4c-a422-4cae-8ea7-b3d5171f58e3
Copilot AI review requested due to automatic review settings July 21, 2026 17:28
@GeekTrainer
GeekTrainer requested a review from aaronpowell as a code owner July 21, 2026 17:28
@github-actions github-actions Bot added website-update PR touches website content or code workflow PR touches workflow automation labels Jul 21, 2026

Copilot AI 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.

Pull request overview

Reorganizes Learning Hub navigation for scalable course, workshop, and video discovery.

Changes:

  • Adds Courses and Videos navigation groups.
  • Promotes Cookbook and renames Resources.
  • Updates workshop-sync instructions for the new taxonomy.
Show a summary per file
File Description
website/src/content/docs/learning-hub/index.md Restructures landing-page sections.
website/astro.config.mjs Reorganizes sidebar navigation.
.github/workflows/copilot-workshops-sync.md Updates workshop navigation instructions.
.github/workflows/copilot-workshops-sync.lock.yml Refreshes compiled workflow metadata.

Review details

  • Files reviewed: 4/4 changed files
  • Comments generated: 1
  • Review effort level: Medium


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).
@GeekTrainer

Copy link
Copy Markdown
Contributor Author

Closing for now — still validating the UX, not ready to merge. Will reopen or raise a fresh PR when it's ready.

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

Labels

website-update PR touches website content or code workflow PR touches workflow automation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants