skillhub/document
2026-07-23 12:23:22 +08:00
..
docs docs: publish SkillHub website 2026-07-23 12:23:22 +08:00
i18n docs: publish SkillHub website 2026-07-23 12:23:22 +08:00
src docs: publish SkillHub website 2026-07-23 12:23:22 +08:00
static docs: publish SkillHub website 2026-07-23 12:23:22 +08:00
.gitignore docs: publish SkillHub website 2026-07-23 12:23:22 +08:00
docusaurus.config.js docs: publish SkillHub website 2026-07-23 12:23:22 +08:00
package.json docs: publish SkillHub website 2026-07-23 12:23:22 +08:00
README.md docs: publish SkillHub website 2026-07-23 12:23:22 +08:00
sidebars.js docs: publish SkillHub website 2026-07-23 12:23:22 +08:00
tsconfig.json feat(docs): initialize Docusaurus documentation website 2026-03-15 18:27:32 +08:00

SkillHub Docs Site

document/ contains the Docusaurus source for the public documentation site served at https://www.astron-skillhub.org/.

Local Development

Install dependencies:

cd document
npm install

Start the docs dev server:

npm run start

Build the production site:

npm run build

Publishing

The repository includes a GitHub Actions workflow at .github/workflows/publish-docs-site.yml.

  • Pushes to main that modify document/** or the workflow file trigger an automatic docs build and GitHub Pages deployment
  • The custom domain is configured through document/static/CNAME
  • Legacy website URLs such as quickstart.html and guide/skill-publish.html are redirected to the current Docusaurus routes via plugin-client-redirects

Sync Rule

To keep https://www.astron-skillhub.org/ aligned with the latest repository content:

  • Treat document/ as the source of truth for the public docs site
  • Update document/docs/** whenever product messaging or public-facing workflow documentation changes materially
  • Keep redirects updated when replacing or renaming public routes