Open Source
GitHub ist die Werkstatt. Die Tür ist eine HTML-Seite.
Journalistinnen, Designer und jemand mit einer Sicherheitslücke treffen euch nicht im Issue-Tracker. Docs, Sponsor, security, ein Satz, dass hier ein Mensch antwortet.
GitHub ist der Ort, an dem die Arbeit liegt. Es ist eine schlechte Startseite für eine Journalistin, für eine Designerin, die euch über ein Reel gefunden hat, oder für jemanden, der nach einer Lücke sucht und nicht im richtigen Repo landet. Die brauchen eine HTML-Tür: was das Projekt ist, wie man euch bezahlt, wie man ein Loch meldet, und dass ihr kein Botnetz seid.
Eine Linkliste aus Discord, Merch und einem vergrabenen Stern-Button bringt genau diese Leute dazu, wieder zu gehen.
Maintainer-Tisch anlegen. Pro, 7€ im Monat, für oss.euername.de, wenn ihr security.txt auf einer Domain wollt, die euch gehört.
Vier Publika, vier Buttons
Leute, die das Projekt benutzen: zuerst Doku oder Quickstart. Nicht euer persönlicher Patreon-Roman.
Leute, die zahlen: GitHub Sponsors oder Open Collective, mit dem Weg zur Rechnung, wenn Firmen das brauchen. Nicht ein Stapel aus vierzig Links.
Leute mit einer Lücke: SECURITY.md oder ein Formular. Nicht ein öffentlicher Discord-Kanal names security. Ein öffentlicher Kanal ist eine Einladung, das Loch vor dem Patch zu zeigen.
Presse und Stellen: neunzig Wörter und Vorträge, wenn ihr welche haltet. Meme-Merch nicht zuerst. Wenn die Presse wirklich kommt, ist der Pressetisch die ausführlichere Ordnung. Auf dem Maintainer-Hub reicht der Verweis.
Was als Text auf der Seite stehen sollte
Ein Satz, was das Projekt tut, ohne Slogan-Suppe. Die Lizenz, beim Namen. Der Pflege-Status, ehrlich: aktiv, Best Effort, oder ihr sucht Maintainer. Die untere Grenze der Laufzeitumgebung, wenn sie Leute beißt (welche Node- oder Python-Linie ihr noch anfasst). Wie Geld angenommen wird, und dass Geld keinen Commit kauft. Der letzte Halbsatz verhindert die Mail, die Sponsoring mit einer Roadmap-Verfügung verwechselt.
Pinnt drei Repos. Den Rest verlinkt als Organisation. Eine Seite, die jedes Archiv der letzten zehn Jahre als Button führt, ist ein Verzeichnis, kein Tisch.
Sicherheit ohne Theater
Keine Tokens auf der Seite. Keine Schritte, wie man eine ungepatchte Lücke nachbaut. Eine Mail-Adresse oder ein Formular, das nicht im öffentlichen Issue landet. Wenn Pro und eine eigene Domain da sind, gehört security.txt dorthin, in dem Format, das ihr auch wirklich abholt. Ein Hinweis auf eine Adresse, die niemand liest, ist Theater.
Der Changelog der Sicherheitsfixes kann öffentlich sein, nachdem der Fix draußen ist. Vorher nicht die Reproduktion.
Sponsoren, die keine Fans sind
Firmen wollen ein Logo in der README und einen Rechnungsweg. Fans wollen einen menschlichen Satz. Beides auf einem Button „Support“ ist in Ordnung, wenn die Seite darunter erklärt, was passiert. Beides gemischt mit einem Token-Verkauf ist der schnellste Weg, die Firma zu verlieren und die Fans zu verwirren. Wenn ihr Krypto nehmt, sagt es getrennt. Wenn nicht, schreibt das nicht aus Versehen in einen generischen „Tip“-Link, der drei Kassen hat.
Eine Brand-Zeile: welches Logo, welche Farben, dass das Logo keine Produkt-Partnerschaft behauptet. Das ist dasselbe Bedürfnis wie bei Pressebildern, nur kleiner.
README und Hub
Die README ist für Leute, die klonen. Der Hub ist für Leute, die nie klonen werden. Den einen Satz doppelt ihr. Die Architektur nicht. Wer nur die README auf GitHub pflegt, erreicht GitHub. Wer nach dem Projektnamen sucht und nicht im richtigen Tab landet, sieht eine Profil-README oft nicht. Eine eigene HTML-Seite schon, wenn sie denselben Namen in den ersten Sätzen trägt.
Konferenzen: wenn ihr über das Projekt sprecht, führt das Badge auf diesen Hub, nicht auf ein persönliches Linkraster. Das Schwesterstück dazu ist die Speaker-Seite. Manche Maintainer brauchen beide. Dann verlinken sie sich, statt zwei widersprüchliche Bios zu pflegen.
Wohin Förderer und Firmen die URL wirklich schicken
Ein Förderantrag, ein Formular einer Stiftung, eine Einkäuferin, die das Logo in die README setzen will: die fragen nach einer Website. Die README allein ist für viele dieser Formulare ein seltsames Ziel, weil sie nach Impressum, nach einem Menschen und nach einem Satz suchen, den sie in ein PDF kopieren können. Der Hub ist dieser Satz plus die vier Buttons. Schreibt, ob Spenden an eine Einzelperson oder an einen Verein gehen, und ob eine Zuwendungsbestätigung existiert. In DACH ist das der Unterschied zwischen „danke“ und einem Beleg, den eine Buchhaltung abheftet. Wenn es keinen Beleg gibt, sagt das. Eine Firma, die einen Beleg erwartet und eine private Kasse findet, zahlt einmal und nie wieder. Das ist kein Steuerrecht in zehn Zeilen. Es ist die Beschriftung des Geld-Buttons, bevor jemand überweist.
Fragen, die in der Maintainer-Pause kommen
Ersetzt die Profil-README das hier? Sie hilft Leuten, die schon auf GitHub sind. Sie ist nicht die Seite, die eine fachfremde Suche nach eurem Namen zuverlässig als aktuelle Tür erkennt, besonders wenn ihr unter mehreren Namen auftretet.
Discord als Community-Button? Zweiter Rang. Zuerst Doku und Issue-Vorlagen, sonst werdet ihr ein Helpdesk in einem Chat, den ihr nicht durchsuchen könnt, wenn ihr krank seid.
Jedes Repo listen? Drei. Die Org für den Rest. Archive als Archive beschriften, damit niemand einen Bug in ein totes Projekt schreibt und euch dafür hasst.
Deutsch oder Englisch? In der Sprache, in der Issues beantwortet werden. Ein deutscher Absatz für Förderer aus DACH ist sinnvoll, wenn Rechnungen und Zuwendungsbestätigungen dort landen. Die Doku-Sprache nicht heimlich auf der Hub-Seite wechseln.
Vier Buttons. Seite anlegen. Den Pflege-Status im Satz halten, nicht im Logo.
Seite erstellen — Pro 7€/Monat
Kostenlos starten. Pro für 7€ / Monat.