Releases
Ein Release-Post ist eine kurze Seite im Blog-Stil, auf die du verlinkst, wenn etwas fertig ist. Er liegt unter einer URL, die dir gehört, hat einen Markdown-Text und kann die ausgelieferten Roadmap-Einträge? anheften.
Release-Posts
Jedes Projekt hat einen Release-Index unter /r/{org}/{project} und eine Seite pro Release unter:
https://opini.dev/r/{org-slug}/{project-slug}/{release-slug}Schreib Releases im Dashboard unter Releases. Jedes hat einen Titel, einen Markdown-Text, ein optionales Veröffentlichungsdatum und eine Liste von Einträgen, die du namentlich nennen willst.
Sichtbarkeit
Drei Sichtbarkeitsstufen, pro Release umschaltbar:
- Öffentlich: im Index gelistet und für Suchmaschinen auffindbar. Der Standard für „fertig zum Lesen“.
- Nur per Link: über die direkte URL erreichbar, aber nirgends gelistet. Gut für leise Launches, Vorschauen für Partner und ungelistete Changelogs.
- Privat: nur für Admins. Für Entwürfe, Post-mortems oder alles, worauf Besucher nicht stoßen sollen.
Ein Release offline zu nehmen löscht es nicht: Stell es auf Privat, und die URL liefert 404, während der Inhalt im Dashboard erhalten bleibt.
Einträge anheften
Im Release-Editor kannst du die Roadmap-Einträge anheften, die tatsächlich ausgeliefert wurden. Leser sehen ihre Titel auf der Release-Seite; wer eine eigene Roadmap anzeigt, holt dieselben Daten aus der öffentlichen API.
Anheften verschiebt einen Eintrag nicht. Einträge laufen durch ihre eigenen Statusspalten (siehe öffentliche Seiten); Releases sind eine ausgewählte Erzählung darüber.
Tags für Releases
Releases können Tags tragen: Sicherheit, breaking, Beta, was dein Projekt braucht. Tags erscheinen im Index, damit Leser nach Art überfliegen können. Unter Tags steht, wie du beim Tippen neue anlegst.
Events
Zwei Webhook-Events verfolgen den Status von Releases:
release.published: wenn ein Release von Privat oder Nur per Link auf Öffentlich wechselt.release.unpublished: wenn ein öffentliches Release zurück auf Privat geht.
Ein typischer Ablauf: Abonniere eine Benachrichtigungs-URL für release.published und poste den Release-Link automatisch in deinen #announce-Kanal. Siehe Webhooks.