# documentation-docusaurus

VSSA-managed Hermes skill for the complete Docusaurus documentation lifecycle:

- Diátaxis information architecture and writing quality;
- Docusaurus v3 configuration, MDX, React Flow and Draw.io;
- evidence registries, generated dossiers and source-to-derived cross-linking;
- Gitea organization/repository setup and safe Git delivery;
- self-hosted Gitea Actions and LEGO Cloud Pages publication;
- build, browser, exact-SHA CI, authenticated readback and deployment verification.

## Authoritative location

- Gitea: <https://gitea.lego-cloud.eu/vssa-v1-skills-code-agent/documentation-docusaurus>
- Branch: `main`
- Maintainer worktree: `/opt/data/documentation-docusaurus-skill`
- Runtime installation: `/opt/data/skills/productivity/documentation-docusaurus` → maintainer worktree

## Validate

```bash
python3 scripts/validate_skill.py
git diff --check
```

## Maintenance

Fetch and fast-forward before editing. Commit reusable changes to this repository, push them, verify exact ref equality, read back the changed artifact through the authenticated Gitea API, require the exact-SHA Actions task to succeed, and verify runtime loading. Other project skill repositories are read-only comparison sources unless their owners explicitly request changes.