Plugin-Ökosystem-Seite
Präsentiere ein Plugin-Ökosystem mit strukturierten Detailseiten, Release Notes und Installationsanleitungen.
In einem Plugin-Verzeichnis entscheidet sich Vertrauen. Besucher:innen suchen keine Werbewörter – sie wollen wissen, was ein Plugin macht, wer es wartet, ob es produktionsreif ist, wie es installiert wird und wie es sich in einem echten EmDash-Stack verhält. Eine strukturierte öffentliche Seite verwandelt diese Antworten in konsistente Seiten statt verstreuter README-Fragmente.
Was jede Plugin-Seite belegen sollte
Beginne mit dem Ergebnis: welches Problem gelöst wird, welche Umgebungen unterstützt werden und welcher Betriebs-Footprint entsteht (Workers, D1, externe APIs). Ergänze danach Kompatibilität, Versionierung und Lizenz. Stelle Links zu Quellcode, Downloads und weiterführender Dokumentation sichtbar bereit. Wenn etwas Beta ist, sag es klar und erkläre, was „Beta“ für Daten und Verfügbarkeit bedeutet.
Konkrete Rollout-Schritte
-
Ein einheitliches Seitentemplate definieren. Standardfelder können Status, Kategorie, Version, Preismodell, Kompatibilität, Repository-Link und Changelog enthalten. Konsistenz hilft Nutzer:innen, Optionen schnell zu vergleichen.
-
Installationsanleitungen veröffentlichen, die der Realität entsprechen. Bevorzuge Befehle und Konfigurations-Snippets, die mit der aktuellen Repo-Struktur funktionieren – zum Beispiel mit Verweis auf
packages/plugins/<name>im EmDash-Monorepo, wenn das die Source of Truth ist. -
Bei jeder relevanten Änderung Release Notes ausliefern. Selbst eine kurze Stichpunktliste ist besser als Schweigen. Verlinke nach Möglichkeit auf GitHub-Compare-Ansichten oder getaggte Releases.
-
Vertrauenssignale ergänzen. Name der Maintainer, Support-Kanal und Sicherheitserwartungen gehören auf die Seite – nicht nur in den Chat. Für Plugins mit Drittanbieter-APIs sollten erforderliche Secrets und Rate Limits dokumentiert sein.
-
Use Cases querverlinken. Verbinde Plugins mit den Szenarien, die sie ermöglichen: Forms für Lead-Erfassung, Webhook Notifier für Automatisierung, Audit Log für Teams mit mehreren Redakteur:innen.
Beispiel: ein neues Plugin für das Listing bewerten
Bevor die Seite live geht, arbeite diese Checkliste durch: Entspricht die Einzeilenbeschreibung dem, was der Code tatsächlich exportiert? Sind Screenshots oder Diagramme korrekt? Ist die Lizenz richtig angegeben? Kann eine neue Nutzerin oder ein neuer Nutzer das Plugin ohne Insiderwissen installieren? Wenn eine Antwort „nein“ lautet, schließe die Lücke, bevor du das Plugin bewirbst.
Betriebsrhythmus
Monatlich: offene Issues prüfen und Statusfelder aktualisieren. Quartalsweise: verwaiste Einträge abkündigen oder als „unmaintained“ markieren und Migrationshinweise ergänzen. Nach größeren EmDash-Releases: Top-Plugins erneut testen und Kompatibilitätsangaben aktualisieren.
Ergebnis
Builder entdecken Plugins schneller, übernehmen sie mit weniger Überraschungen und behandeln dein Ökosystem als ernsthafte Infrastruktur – nicht als Prospekt.