Learning hub#821
Merged
aaronpowell merged 21 commits intostagedfrom Feb 26, 2026
Merged
Conversation
- Add Astro Content Collection for learning-hub articles - Move 5 fundamentals articles into website/src/content/learning-hub/ - Create ArticleLayout.astro for rendering markdown articles - Create index page listing all articles in recommended reading order - Create dynamic [slug].astro route for individual articles - Add Learning Hub to main navigation and homepage cards - Add article prose and index page CSS styles - Update internal links to use website URLs
…ls and Reference sections
- Rename samples page to /learning-hub/cookbook/ - Remove Samples from top navigation bar - Add Cookbook to learning hub sidebar under Hands-on section - Add Cookbook card to learning hub index page - Add redirect from /samples/ to /learning-hub/cookbook/ - Add breadcrumb navigation back to Learning Hub
Contributor
There was a problem hiding this comment.
Pull request overview
This pull request introduces a comprehensive "Learning Hub" section to the website, providing educational articles and resources for GitHub Copilot users. The Learning Hub replaces the previous "Samples" page (now "Cookbook") and organizes content into three categories: Fundamentals, Reference, and Hands-on. The implementation includes new routing, layouts, content collections, styling, and six foundational articles covering core Copilot concepts.
Changes:
- New Learning Hub section with index page, article pages, and sidebar navigation
- Six educational articles with frontmatter schemas and markdown content
- Astro content collections configuration for learning-hub articles
- Redirect from /samples/ to /learning-hub/cookbook/
- Navigation updates throughout the site
- Responsive CSS styling for article layouts and sidebar
Reviewed changes
Copilot reviewed 16 out of 16 changed files in this pull request and generated 6 comments.
Show a summary per file
| File | Description |
|---|---|
| website/src/pages/learning-hub/index.astro | Landing page displaying organized article categories with cards |
| website/src/pages/learning-hub/[slug].astro | Dynamic route for rendering individual articles |
| website/src/pages/learning-hub/cookbook/index.astro | Moved samples page with breadcrumb navigation |
| website/src/layouts/ArticleLayout.astro | New layout with sidebar navigation for article pages |
| website/src/layouts/BaseLayout.astro | Updated main navigation to include Learning Hub |
| website/src/pages/index.astro | Added Learning Hub card to homepage |
| website/src/content.config.ts | Content collection schema for learning-hub articles |
| website/src/content/learning-hub/*.md | Six educational articles covering fundamentals, configuration, and examples |
| website/public/styles/global.css | Styling for sidebar, article content, and learning hub components |
| website/astro.config.mjs | Redirect configuration from old samples path |
Replace all prompt file references with skills guidance throughout the Learning Hub. Skills are the preferred customization primitive because they support agent discovery via extended frontmatter, can bundle reference files and scripts, and are portable across coding agent systems via the Agent Skills specification. - Create what-are-agents-skills-instructions.md (replaces prompts article) - Create creating-effective-skills.md (replaces prompts tutorial) - Delete what-are-agents-prompts-instructions.md and creating-effective-prompts.md - Update copilot-configuration-basics.md directory structure and examples - Update defining-custom-instructions.md comparisons and cross-references - Update glossary: deprecate Prompt entry, add Skill definition - Update understanding-copilot-context.md and before-after examples - Update learning-hub index.astro slugs Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Add card-with-count class to the Learning Hub card so its emoji icon aligns horizontally with the title, matching all other cards in the grid. Previously it used the base card class which stacked the icon above the content. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
…agent Add four high-priority articles identified by gap analysis against nishanil/copilot-guide: - Building Custom Agents: personas, tools, MCP integration, patterns - Understanding MCP Servers: what MCP is, configuration, agent usage - Automating with Hooks: lifecycle events, hooks.json, practical examples - Using the Copilot Coding Agent: setup steps, issue assignment, PR workflow Update index.astro fundamentalsOrder to include all 10 articles. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
- Replace 'Building Custom Agents (coming soon)' with real links - Add Hook and Coding Agent entries to the glossary - Add MCP Servers learning hub link to glossary MCP entry Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Add a left sidebar to the Learning Hub index page matching the pattern already used on individual article pages. The sidebar lists all articles grouped by section (Fundamentals, Reference, Hands-on) and stays sticky while scrolling, reducing vertical scroll for the now 10-article list. Also update ArticleLayout.astro fundamentalsOrder to include the 4 new articles added in the previous commit. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Tables in article content were invisible due to no border styles. Add collapsed borders, a tinted header row, and a subtle hover effect scoped to .article-content table elements. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
- Remove non-existent copilotAgentCommit event from all articles - Add 5 missing hook events: preToolUse, postToolUse, agentStop, subagentStop, errorOccurred - Fix hooks location from .copilot/hooks.json to .github/hooks/*.json - Add powershell field to config format - Add preToolUse security gating example (approve/deny tool executions) - Update glossary and coding agent article cross-references Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
…o resources - Expand 'Specifying an Agent' into full 'Using Custom Agents' section with agent profile format, storage locations, and selection methods - Add 'Agent Skills and the Coding Agent' section covering how skills are automatically loaded, directory structure, and SKILL.md format - Add comparison table: Instructions vs Skills vs Custom Agents - Add 'Leveraging Community Resources' section linking to this repo's agents, skills, and hooks directories - Update best practices with skills and agent recommendations - Update FAQ to cover both agents and skills - Add skills article to related articles and Next Steps Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
- New article covering plugin concepts, finding/installing/managing plugins, marketplace browsing, and how this repo serves as a plugin marketplace - Add 'installing-and-using-plugins' to fundamentalsOrder in index.astro and ArticleLayout.astro - Add Plugin entry to terminology glossary Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
- Fix double-path issue: ../learning-hub/X/ → ../X/ (9 links) - Fix wrong depth for top-level pages: ../agents/ → ../../agents/ (4 links) - Fix absolute paths missing base URL: /learning-hub/X/ → ../X/ (7 links) - Fix dead file references: link to GitHub source instead (3 links) - Verified 0 broken links remaining via Playwright crawl of all 12 articles Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Move duplicated fundamentalsOrder and referenceOrder arrays from index.astro and ArticleLayout.astro into a shared config file at src/config/learning-hub.ts. Both consumers now import from the single source of truth. Addresses PR review comment about maintenance burden of keeping two copies in sync. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Contributor
There was a problem hiding this comment.
Pull request overview
Copilot reviewed 22 out of 22 changed files in this pull request and generated 6 comments.
Comments suppressed due to low confidence (3)
website/src/pages/learning-hub/index.astro:116
- The emoji "📖" is used without accessibility attributes. For better accessibility, wrap it in a
<span aria-hidden="true">📖</span>to hide it from screen readers, as it's decorative and the actual reading time text conveys the meaning.
<span class="meta-item">📖 {article.data.estimatedReadingTime}</span>
website/src/content/learning-hub/copilot-configuration-basics.md:50
- The word "Organisation" uses British English spelling. For consistency with the term "organization" used elsewhere in the same paragraph and article, use American English spelling "Organization".
Organisation settings allow administrators to enforce Copilot policies across all repositories within an organization. These settings can include defining custom agents, creating globally applied instructions, enabling or disabling Copilot, managing billing, and setting usage limits. These policies may not be enforced in the IDE, depending on the IDE's support for organization-level settings, but will apply to Copilot usage on GitHub.com.
website/src/content/learning-hub/copilot-configuration-basics.md:48
- The word "Organisation" uses British English spelling. For consistency with the rest of the codebase and the term "organization" used elsewhere in the same article (line 50), consider using American English spelling "Organization" consistently throughout.
### Organisation Settings (GitHub.com only)
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
This pull request introduces foundational support for a new "Learning Hub" section in the website, including content structure, configuration, and styling. The changes enable a scalable system for organizing educational articles and resources, along with a modern sidebar-driven layout and article presentation. The most important updates are grouped below.