Torna al journal

Open source

GitHub è l’officina. Il giornalista non clona

Docs, sponsor, security, una bio di novanta parole. Quattro bottoni, non dodici. Il README resta per chi clona. L’hub è per chi ti ha trovato su Google dopo un CVE.

30 ottobre 20266 minLinkForge Editorial

GitHub è dove vive il lavoro. È una homepage terribile per un giornalista, per un designer che ti ha trovato su TikTok, per un CISO che ha cercato un CVE. I linktree pieni di Discord, merch e un bottone stella sepolto insegnano ai civili ad andarsene.

Metti la scrivania del maintainer su LinkForge. Pro a 7€ al mese se vuoi oss.tuonome.it.

Quattro pubblici, quattro bottoni

Pubblico Primo bottone Mai primo
Chi usa Docs o quickstart Il dramma del Patreon personale
Sponsor GitHub Sponsors o Open Collective Uno stack di quaranta link
Security security.md o un form Un Discord pubblico
Stampa e lavoro Bio di novanta parole e i talk Il merch dei meme

Nel testo che si può crawllare: una riga sul progetto, senza zuppa di slogan; la licenza; lo stato di manutenzione (attivo, best effort, cerco comaintainer); il pavimento di versione Python o Node; come prendi i soldi, e che i soldi non comprano un commit.

Un #security pubblico su Discord è un modo per farsi bucare. Linka un form privato o un’email. Se hai il dominio Pro, security.txt sta lì. Non incollare token. Non incollare i passi di riproduzione di un issue non patchato. La pagina è pubblica. Un giornalista e un crawler la leggono allo stesso modo.

Le aziende sponsorizzano per mettere un logo nel README. Mostra il brand kit e la strada della fattura, in euro se fatturi in Italia, con la partita IVA detta e non inventata. I fan sponsorizzano perché gli piaci. Mostra una frase umana. Mischiare entrambi su un bottone «support» va bene. Mischiarli con un mint crypto è come perdi l’azienda.

Il README è per chi clona. L’hub è per gli umani che non cloneranno mai. Duplica la one-liner. Non duplicare l’architettura. Tre repo in evidenza. Il resto è l’org. Discord è secondario. Primari sono docs e issue template, così non diventi un helpdesk. Se la settimana di lancio è anche Product Hunt, l’hub di lancio è un cugino: waitlist e changelog. Non due identità.

Il README del profilo GitHub aiuta chi è già su GitHub. Non ranka il tuo nome come una pagina sul tuo dominio o su LinkForge. Tieni entrambi. La pagina è quella che un CISO apre senza un account.

Quattro persone, una pagina, un martedì

Una libreria Python mantenuta da una persona a Torino. In una settimana arrivano quattro estranei, e nessuno di loro vuole il vostro merch.

Chi la installa vuole la quickstart e il pavimento di versione. Il bottone uno è la docs. La one-liner in HTML ripete il README e poi si ferma: niente architettura duplicata. La licenza è una parola, lo stato è «attivo» o «best effort» o «cerco un comaintainer», non uno slogan.

Un’azienda che vuole il logo nel README vuole il brand kit e come si fattura, in euro, con la strada del pagamento. I soldi non comprano un commit: scrivetelo. I fan che vi vogliono bene leggono una frase umana sullo stesso bottone «support», non un mint. Mescolare i due pubblici va bene. Mescolare un’azienda e una moneta inventata no.

Chi ha trovato un CVE non deve finire in un Discord pubblico. Un form o un’email, e security.txt sul dominio se ce l’avete. Niente token in pagina. Niente passi di riproduzione di un buco aperto. La pagina è indicizzata: un giornalista e un crawler la leggono come il CISO.

La stampa e un’offerta di lavoro vogliono novanta parole e i talk, non la stella di GitHub sepolta. Tre repo in evidenza. L’org per il resto. Il README del profilo GitHub resta per chi è già lì. Non sostituisce la pagina che si apre senza account alle 23.

Una volta al mese: i link delle docs risolvono, la versione minima è ancora vera, l’email di security è ancora vostra. Non aggiungete un quinto bottone perché un social ve l’ha chiesto.

FAQ

Il README del profilo basta?

Per i nativi di GitHub, aiuta. Per un giornalista alle 23, no.

Elenco ogni repo?

No. Tre pin. L’org per il resto.

Discord è il bottone comunità?

Secondario. Prima docs e template di issue.

Prezzo?

La pagina parte free. Il dominio e security.txt sul tuo nome: Pro a 7€.


Quattro bottoni. Crea la pagina.

Crea la mia pagina — Pro 7€/mese

Gratis per iniziare. Pro a 7€ / mese.