# documentation-docusaurus-vssa

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`
- Runtime package: `documentation-docusaurus-vssa` (complete repository package).
- Compatibility: install `templates/documentation-docusaurus.md` as `documentation-docusaurus/SKILL.md`; old callers still load this VSSA adoption.
- Generic owner: `documentation-docusaurus-global`, from the distinct `home-v1-skills-code-agent/documentation-docusaurus` repository.
- Repository URL and all VSSA-specific reference content remain independently maintained.

## 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.