docs: site-admin guide — where reference plugin ZIPs come from + rollout steps

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_0155v2aT8AG1kZDQEZiCLBWC

docs/de/manual/site-admin-guide.md

@@ -99,6 +99,25 @@ Mitgelieferte Referenz-Plugins: `toc` (Inhaltsverzeichnis),
 (Diagramm-Blöcke), `drawio` (vollwertiges draw.io-Bearbeiten),
 `section-styles-basic` (farbige Hinweiskästen).
 
+**Woher kommen die ZIPs der Referenz-Plugins?** Sie liegen den
+Server-Images nicht bei — sie werden aus dem Repository gebaut (Node 22
+
+- pnpm, einmalig `pnpm install` im Repo-Wurzelverzeichnis):
+
+```sh
+cd packages/plugins/<name>   # toc | page-index | mermaid | drawio | section-styles-basic
+pnpm build                   # → dist/<id>-<version>.zip — diese Datei hochladen
+```
+
+Der `drawio`-Build lädt beim ersten Lauf sein gepinntes Editor-Bundle
+von GitHub und packt ein ~27-MiB-ZIP (innerhalb des 64-MiB-Limits für
+Plugin-Uploads); die anderen vier bauen offline in Sekunden.
+
+**Typischer Ablauf:** ZIP hochladen, die abgeschottete Vorschau prüfen,
+den Instanz-Modus auf `optional` stellen und das Plugin dann je Teich
+aktivieren (Teich-Einstellungen → **Plugins** — in persönlichen Teichen
+macht das der Eigentümer selbst).
+
 ### Personen
 
 Die Personenverwaltung: Konten suchen, deaktivieren/aktivieren,

docs/manual/site-admin-guide.md

@@ -90,6 +90,23 @@ Shipped reference plugins: `toc` (table of contents), `page-index`
 (label-filtered page list), `mermaid` (diagram blocks), `drawio`
 (full draw.io editing), `section-styles-basic` (colored callouts).
 
+**Getting the reference plugin ZIPs.** They are not bundled with the
+server images — build them from the repository (Node 22 + pnpm, one-time
+`pnpm install` at the repo root):
+
+```sh
+cd packages/plugins/<name>   # toc | page-index | mermaid | drawio | section-styles-basic
+pnpm build                   # → dist/<id>-<version>.zip — upload that file
+```
+
+The `drawio` build downloads its pinned editor bundle from GitHub on the
+first run and packs a ~27 MiB ZIP (within the 64 MiB plugin upload
+limit); the other four build offline in seconds.
+
+**Typical rollout:** upload the ZIP, check the sandboxed preview, switch
+the instance mode to `optional`, then enable the plugin per pond (pond
+settings → **Plugins** — in personal ponds the owner does this).
+
 ### Users
 
 The user manager: search accounts, disable/enable, resend verification