Commit Graph

20 Commits

Author SHA1 Message Date
Copilot
2df1601661 Remove redundant content/learning-hub symlinks; consolidate into docs/learning-hub (#1075)
Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: aaronpowell <434140+aaronpowell@users.noreply.github.com>
2026-03-19 13:36:52 +11:00
Aaron Powell
52dd53d3a3 website tweaks (#952)
* Adding nav to learning hub

* Simplifying the home page

* Fixing footer spacing
2026-03-10 16:03:53 +11:00
Copilot
1b15663c46 Update docs to reflect awesome-copilot as default plugin marketplace in CLI and VS Code (#901)
* Initial plan

* docs: update plugin discovery for default marketplace in CLI and VS Code

Co-authored-by: aaronpowell <434140+aaronpowell@users.noreply.github.com>

* docs: revert README.md changes (covered by #900), update README.plugins.md

Co-authored-by: aaronpowell <434140+aaronpowell@users.noreply.github.com>

* fix: update plugin template in constants.mjs so README.plugins.md survives rebuilds

Co-authored-by: aaronpowell <434140+aaronpowell@users.noreply.github.com>

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: aaronpowell <434140+aaronpowell@users.noreply.github.com>
2026-03-06 16:26:26 +11:00
Aaron Powell
e6437902d6 Fix sidebar navigation text contrast in light mode (#902)
* Fixing the action link

* Fix sidebar navigation text contrast in light mode

- Use --sl-color-text-invert instead of --sl-color-white for active
  sidebar item, fixing near-black text on dark purple background
  (contrast ~2.5:1 → ~7.1:1)
- Bump inactive sidebar links to font-weight 500 for better readability

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

---------

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-03-06 16:10:05 +11:00
Copilot
78e3ea29c2 [WIP] Fix URL path issue in learning hub (#895)
* Initial plan

* fix: use relative links in learning-hub index to preserve base path

Co-authored-by: aaronpowell <434140+aaronpowell@users.noreply.github.com>

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: aaronpowell <434140+aaronpowell@users.noreply.github.com>
2026-03-06 10:22:25 +11:00
Aaron Powell
40fd1a6c72 Migrate website to Starlight with full-text resource search (#883)
* Add search functionality to Learning Hub index page

Add a client-side search bar that filters articles by title, description,
and tags. Sections with no matching results are hidden automatically.
Uses the existing .search-bar CSS pattern from the cookbook page.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* chore: remove deprecated layouts, theme script, and learning-hub config

Phase 5 cleanup of Starlight migration:
- Delete BaseLayout.astro (replaced by StarlightPage)
- Delete ArticleLayout.astro (replaced by Starlight docs rendering)
- Delete theme.ts (Starlight has built-in theme toggle)
- Delete src/config/learning-hub.ts (sidebar order now in astro.config.mjs)
- Replace learning-hub glob collection with Starlight docs collection in content.config.ts
- Keep search.ts (still used by homepage and all resource page scripts)

Build verified: 23 pages, no errors.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* Migrate website to Starlight with full-text resource search

- Replace bespoke Astro layouts with Starlight integration
  - Homepage and resource pages use StarlightPage wrapper
  - Learning Hub articles rendered via Starlight docs collection
  - Starlight provides search, theme toggle, sidebar, ToC, a11y

- Add custom Pagefind integration for resource search
  - All 614 agents/skills/instructions/hooks/workflows/plugins
    indexed as custom records with deep-link URLs
  - Type filter pills (horizontal pill toggles) above results
  - Search results link directly to resource modals via #file= hash

- Move global.css to src/styles/ for Vite processing
  - Scope CSS reset to #main-content to avoid Starlight conflicts
  - Full-width page gradient via body:has(#main-content)
  - Light/dark theme support with Starlight gray scale inversion

- Delete old layouts (BaseLayout, ArticleLayout), theme.ts, config

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* Address PR review feedback

- Fix pagefind-resources.ts header comment (pagefind:true not false)
- Remove unused base variable in cookbook/index.astro
- Replace hardcoded /awesome-copilot/ paths with relative links in index.md
- Delete stale public/styles/global.css (source of truth is src/styles/)
- Replace fragile getBasePath() with Astro config base in pagefind integration
- Document pagefind:true reasoning in astro.config.mjs
- Use proper visually-hidden pattern + :focus-visible ring for filter pills
- Remove dead header/nav/theme CSS from global.css (~160 lines)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

---------

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-03-05 21:50:44 +11:00
Bruno Borges
77cfe63067 Add Agentic Workflows article to Learning Hub (#839)
* Add Agentic Workflows article to Learning Hub

Covers what agentic workflows are, how to consume community
workflows from Awesome Copilot, and how to contribute new ones.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* Update website/src/content/learning-hub/agentic-workflows.md

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

---------

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
2026-03-02 10:51:03 +11:00
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
e0636e8165 fix: resolve 27 broken links across Learning Hub articles
- 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>
2026-02-26 14:48:23 +11:00
Aaron Powell
0758c957c5 docs: fixing links 2026-02-26 14:38:12 +11:00
Aaron Powell
1752caf479 docs: Updating how you mention files to be cross-tool 2026-02-26 14:37:01 +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
9d4e024f24 docs: expand coding agent article with custom agents, skills, and repo 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>
2026-02-26 14:21:57 +11:00
Aaron Powell
31c41a6a1c fix: align hooks docs with official GitHub Copilot hooks spec
- 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>
2026-02-26 14:08:20 +11:00
Aaron Powell
48ca6b237f docs: update cross-references and glossary for new articles
- 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>
2026-02-26 12:34: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
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