31 lines
1.5 KiB
Markdown
31 lines
1.5 KiB
Markdown
# 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.
|