Files
skillshare/website/sidebars.ts
T
Willie 2c3003e04f feat(website): complete website revamp — Diátaxis IA, blog, recipes, quickstarts
Restructure the entire documentation site following the Diátaxis framework
(Learn / How-to / Understand / Reference) with new content across 110 files.

## Information Architecture (M1)
- Move all docs to Diátaxis directory structure (learn/, how-to/, understand/, reference/)
- Add client-redirects plugin for old URL compatibility
- Rewrite sidebar, navbar, and footer to match new IA
- Update all internal cross-references

## Homepage + Quickstarts (M2)
- Add scenario entry cards to homepage with hand-drawn design
- 5 quickstart pages: Claude Code, GitHub Copilot (with copy mode recommendation),
  Codex, Multiple Tools, Dev Containers, Playground

## Blog + Changelog (M3)
- Enable Docusaurus blog plugin with authors.yml
- 5 blog posts: 5-min tutorial, managing 50+ skills, skillshare vs vercel/skills
  comparison, team sharing patterns, write your first skill
- Static /changelog page from CHANGELOG.md

## Recipes + Philosophy (M4)
- 5 recipe pages: CI/CD validation, enterprise skills, project setup,
  cross-machine sync, team onboarding
- 3 philosophy pages: why-local-first, security-first, sync-modes-explained

## Content Polish
- Cross-validate all content against CLI source (19 inaccuracies fixed)
- Lowercase "skillshare" throughout (avoid brand conflict with Skillshare Inc.)
- Add registry.yaml to file structure and Key Paths docs
- Highlight multi-platform git support (GitHub, GitLab, Bitbucket, Gitea,
  Azure DevOps, AtomGit, Codeberg)
- Standardize brew install command
- Add AsciinemaPlayer component (cast recordings pending)
2026-02-26 04:52:29 +08:00

210 lines
5.9 KiB
TypeScript

import type {SidebarsConfig} from '@docusaurus/plugin-content-docs';
const sidebars: SidebarsConfig = {
docsSidebar: [
'intro',
{
type: 'category',
label: 'Learn',
collapsed: false,
items: [
'getting-started/index',
'getting-started/first-sync',
'getting-started/from-existing-skills',
'getting-started/quick-reference',
{
type: 'category',
label: 'Quickstarts',
items: [
'learn/with-claude-code',
'learn/with-copilot',
'learn/with-codex',
'learn/with-multiple-tools',
'learn/with-devcontainer',
'learn/with-playground',
],
},
],
},
{
type: 'category',
label: 'How-To',
items: [
'how-to/index',
{
type: 'category',
label: 'Daily Tasks',
items: [
'how-to/daily-tasks/daily-workflow',
'how-to/daily-tasks/skill-discovery',
'how-to/daily-tasks/backup-restore',
'how-to/daily-tasks/project-workflow',
'how-to/daily-tasks/creating-skills',
'how-to/daily-tasks/organizing-skills',
'how-to/daily-tasks/best-practices',
],
},
{
type: 'category',
label: 'Sharing & Teams',
items: [
'how-to/sharing/project-setup',
'how-to/sharing/organization-sharing',
'how-to/sharing/cross-machine-sync',
'how-to/sharing/hub-index',
],
},
{
type: 'category',
label: 'Advanced',
items: [
'how-to/advanced/migration',
'how-to/advanced/local-first',
'how-to/advanced/docker-sandbox',
'how-to/advanced/security',
],
},
{
type: 'category',
label: 'Recipes',
items: [
'how-to/recipes/index',
'how-to/recipes/ci-cd-skill-validation',
'how-to/recipes/private-enterprise-skills',
'how-to/recipes/skill-per-project-workflow',
'how-to/recipes/cross-machine-sync-recipe',
'how-to/recipes/team-onboarding-recipe',
],
},
],
},
{
type: 'category',
label: 'Understand',
items: [
'understand/index',
'understand/source-and-targets',
'understand/sync-modes',
'understand/tracked-repositories',
'understand/skill-format',
'understand/project-skills',
'understand/declarative-manifest',
{
type: 'category',
label: 'Design Philosophy',
items: [
'understand/philosophy/why-local-first',
'understand/philosophy/security-first',
'understand/philosophy/comparison',
'understand/philosophy/skill-design',
'understand/philosophy/sync-modes-explained',
],
},
],
},
{
type: 'category',
label: 'Reference',
collapsed: true,
items: [
'reference/index',
{
type: 'category',
label: 'Commands',
items: [
'reference/commands/index',
{
type: 'category',
label: 'Core',
items: [
'reference/commands/init',
'reference/commands/install',
'reference/commands/uninstall',
'reference/commands/list',
'reference/commands/search',
'reference/commands/sync',
'reference/commands/status',
],
},
{
type: 'category',
label: 'Skill Management',
items: [
'reference/commands/new',
'reference/commands/check',
'reference/commands/update',
'reference/commands/upgrade',
],
},
{
type: 'category',
label: 'Target Management',
items: [
'reference/commands/target',
'reference/commands/diff',
],
},
{
type: 'category',
label: 'Sync Operations',
items: [
'reference/commands/collect',
'reference/commands/backup',
'reference/commands/restore',
'reference/commands/trash',
'reference/commands/push',
'reference/commands/pull',
],
},
{
type: 'category',
label: 'Security & Utilities',
items: [
'reference/commands/audit',
'reference/commands/hub',
'reference/commands/log',
'reference/commands/doctor',
'reference/commands/ui',
'reference/commands/version',
],
},
],
},
{
type: 'category',
label: 'Targets',
items: [
'reference/targets/index',
'reference/targets/supported-targets',
'reference/targets/adding-custom-targets',
'reference/targets/configuration',
],
},
{
type: 'category',
label: 'Appendix',
items: [
'reference/appendix/index',
'reference/appendix/environment-variables',
'reference/appendix/file-structure',
'reference/appendix/url-formats',
],
},
],
},
{
type: 'category',
label: 'Troubleshooting',
items: [
'troubleshooting/index',
'troubleshooting/troubleshooting-workflow',
'troubleshooting/common-errors',
'troubleshooting/windows',
'troubleshooting/faq',
],
},
],
};
export default sidebars;