Commit Graph

10 Commits

Author SHA1 Message Date
Aaron Powell
d73c0bb1f3 Apply suggestions from code review
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
2026-02-26 16:33:14 +11:00
Aaron Powell
0637cad186 refactor: extract Learning Hub article ordering into shared config
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>
2026-02-26 14:59:50 +11:00
Aaron Powell
4b25ed4543 docs: add Learning Hub article on installing and using plugins
- 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>
2026-02-26 14:32:36 +11:00
Aaron Powell
2d75b4429f feat: add sticky sidebar navigation to Learning Hub index
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>
2026-02-26 12:50:19 +11:00
Aaron Powell
cb8287b81a docs: add 4 new Learning Hub articles for agents, MCP, hooks, coding 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>
2026-02-26 12:34:12 +11:00
Aaron Powell
a01f3d82c5 docs: replace prompts with skills across Learning Hub
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>
2026-02-26 12:18:23 +11:00
Aaron Powell
57634b6231 feat: move samples into learning hub as Cookbook
- 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
2026-02-11 14:02:14 +11:00
Aaron Powell
6bb024224b feat: add terminology glossary and split learning hub into Fundamentals and Reference sections 2026-02-11 12:12:41 +11:00
Aaron Powell
ba7f608a5f feat: add before/after customization examples article to learning hub 2026-02-11 12:10:17 +11:00
Aaron Powell
a124e133cb feat: migrate learning-hub articles into Astro website
- 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
2026-02-10 17:30:30 +11:00