Merge pull request 'refactor: reference diagrams-drawio' (#1) from refactor/diagrams-drawio-reference into test
This commit was merged in pull request #1.
This commit is contained in:
@@ -15,7 +15,7 @@ metadata:
|
||||
framework: Diátaxis
|
||||
hermes:
|
||||
tags: [docusaurus, documentation, diataxis, drawio, mdx, react-flow]
|
||||
related_skills: [drawio-main]
|
||||
related_skills: [diagrams-drawio]
|
||||
compatibility: Designed for Docusaurus v3. Works with Cline, Claude Code, GitHub Copilot, OpenAI Codex, and other compatible agent environments
|
||||
---
|
||||
|
||||
@@ -32,7 +32,7 @@ This is the primary project-adopted skill for **3D Architecture Wizzard** (`3dar
|
||||
- Application: https://gitea.lego-cloud.eu/corp-v1-3darch/corp-v1-3darch
|
||||
- Documentation: https://gitea.lego-cloud.eu/corp-v1-3darch/corp-v1-3darch-documentation
|
||||
- Environment namespace: `CORP_V1_3DARCH_*`
|
||||
- Global diagram skill: https://gitea.lego-cloud.eu/home-v1-skills-code-agent/drawio-main
|
||||
- Global diagram skill: https://gitea.lego-cloud.eu/home-v1-skills-code-agent/diagrams-drawio
|
||||
- Global glossary skill: https://gitea.lego-cloud.eu/home-v1-skills-code-agent/corp-v1--glossary
|
||||
- Project automation: none; no scheduler job is authorized.
|
||||
|
||||
@@ -160,7 +160,7 @@ Use `@xyflow/react` when validated documentation data needs an interactive roadm
|
||||
|
||||
### Draw.io source diagrams
|
||||
|
||||
When a page needs a Draw.io diagram, keep the editable `.drawio` XML in the documentation repository and render that source directly with `docusaurus-plugin-drawio`. Load `drawio-main` to author or change the diagram, then follow [references/drawio-source-diagrams.md](references/drawio-source-diagrams.md) to install the plugin with pnpm, register it, consume the source from MDX with `@theme/Drawio` and `!!raw-loader!`, select multi-page diagrams, and verify the production build and browser rendering. An exported PNG/SVG alone is not an onboarded source diagram.
|
||||
When a page needs a Draw.io diagram, keep the editable `.drawio` XML in the documentation repository and render that source directly with `docusaurus-plugin-drawio`. Load `diagrams-drawio` to author or change the diagram, then follow [references/drawio-source-diagrams.md](references/drawio-source-diagrams.md) to install the plugin with pnpm, register it, consume the source from MDX with `@theme/Drawio` and `!!raw-loader!`, select multi-page diagrams, and verify the production build and browser rendering. An exported PNG/SVG alone is not an onboarded source diagram.
|
||||
|
||||
### Interactive Elements (Use Sparingly)
|
||||
|
||||
|
||||
@@ -7,7 +7,7 @@ Use this workflow when a Docusaurus v3 site must render an editable Draw.io sour
|
||||
- Commit the editable `.drawio` XML in the documentation repository.
|
||||
- Render that source directly in MDX; do not make a PNG/SVG export the only authoritative artifact.
|
||||
- Keep the source adjacent to, or in a clearly named diagram directory near, the page that consumes it.
|
||||
- Use the global `drawio-main` skill to author and validate diagram content.
|
||||
- Use the global `diagrams-drawio` skill to author and validate diagram content.
|
||||
- Use this `documentation-docusaurus` skill to onboard and render the source in Docusaurus.
|
||||
|
||||
Recommended layout:
|
||||
|
||||
Reference in New Issue
Block a user