Retour au journal

Open source

GitHub est l’atelier. La porte, pour les autres, est une page HTML

Un journaliste, un designer, quelqu’un de la sécurité : ils ont besoin de savoir ce que c’est, comment financer, comment signaler un trou sans le poster en public, et qu’un humain est encore là.

30 octobre 20266 minLinkForge Editorial

GitHub est là où le code vit. C’est une mauvaise page d’accueil pour un journaliste pressé, un designer qui a vu une vidéo, ou quelqu’un de la sécurité qui a cherché le nom du projet après un avis. Ces gens ont besoin d’une porte HTML : ce que c’est, comment te payer, comment signaler une faille sans la publier, et la preuve qu’un humain maintient. Une liste pleine de Discord, de goodies et d’un « star le dépôt » enterré les fait partir.

Le README reste le document pour ceux qui clonent. Le hub est le document pour les autres. Duplique la description d’une ligne. Ne duplique pas le schéma d’architecture.

Quatre publics, quatre portes

Les utilisateurs. Premier bouton : la doc ou le démarrage, nommé par le résultat — « installer l’outil en ligne de commande ». Pas le drame du mécénat. Une ligne : ce que ça fait, la licence, le langage et la version minimale, et le statut de maintenance avec des mots que tu honoreras — actif, au mieux, ou en recherche de co-mainteneurs. « Actif » alors que les tickets restent sans réponse pendant un an, c’est comme ça que la confiance meurt. Dis « au mieux » si c’est la vérité.

Les sponsors. Un bouton vers GitHub Sponsors ou Open Collective, plus la phrase sur ce que l’argent n’achète pas : pas une pull request fusionnée, pas une fonction privée, pas tes week-ends. Les entreprises sponsorisent pour un logo. Montre les tailles et le chemin de facture. Les personnes sponsorisent parce qu’elles aiment le travail. Une phrase humaine. Un bouton « sponsoriser » peut servir les deux si la destination explique les paliers. Mélanger le sponsoring et une vente de jetons, c’est comme ça qu’un juriste ferme l’onglet. Ne le fais pas sur la même page sans une séparation très explicite, et probablement pas du tout si tu veux l’entreprise.

La sécurité. Un chemin privé seulement : un mail ou un formulaire qui ne publie pas le rapport. Lie le SECURITY.md du dépôt. Jamais un salon public appelé sécurité. Jamais un tweet de prime qui demande de coller les détails. Si tu as un domaine en Pro, tu peux y héberger un security.txt. Le hub doit quand même pointer vers la politique en langage humain. Pas les étapes de reproduction d’un problème non corrigé sur la page. Pas de jetons, de clés ou de données clients dans la bio : ils seraient aussi copiés dans llms.txt si le fichier est public. Ce miroir est décrit dans llms.txt.

Presse et postes. Une bio d’une centaine de mots, un portrait, les talks si tu parles. Les goodies en dernier, s’il y en a. Un petit projet peut garder ces mots sur ce hub et se passer d’un second site.

Là où les champs à un seul lien regardent

Le site du profil GitHub, un badge de conférence, une vidéo qui a explosé sans prévenir, l’URL « homepage » d’un registre de paquets : tous ce hub. Cinq liens gratuits correspondent aux quatre publics plus un journal des versions. 7 € par mois pour oss.tonnom.com avec le certificat, l’hôte qui fait aussi que security.txt a l’air d’être à toi.

La première ligne du README lie le hub pour « qui maintient et comment financer ». Le hub lie le README pour « comment construire ». Aucun ne cherche à être l’autre.

Le statut de maintenance est une fonction. Écris-le là où quelqu’un qui ouvre un ticket le verra, pas seulement dans un ticket épinglé de 2022. Si tu es en pause, dis ce que la pause veut dire : correctifs de sécurité seulement, pas de fonctions, recherche d’un mainteneur. Si tu as passé la main, nomme la personne et lie sa page. Un projet qui a l’air maintenu et ne l’est pas sera cité comme maintenu. Garde la phrase de statut dans la bio pour que le miroir soit honnête.

Une ligne de version — « 2.4.1, mars, corrige le parseur de dates » — fait plus pour un visiteur technique qu’une mission. Lie la page des releases. Sur le hub, répète la dernière version en texte.

Ne mets pas en héros un Discord que tu ne modères pas, un fil, une plateforme de cours qui laisse croire que le projet est un entonnoir vers le cours — dis-le si c’est vrai, ne le cache pas. Pas un essai politique sur la porte du projet. Ta page personnelle peut exister. La page du projet doit laisser installer le logiciel sans test de loyauté. Deux URL si les deux comptent.

Pas de faux compteurs de téléchargements. Les lecteurs techniques le voient, et un chiffre inventé est celui qui restera. Si tu veux un chiffre réel, prends-le dans le registre au moment où tu l’écris, et date-le. Sinon, omets-le.

Le jour d’une version : mets à jour la phrase, confirme que le bouton doc ouvre la nouvelle doc, confirme que le bouton sponsor atterrit encore sur le compte qui reçoit. Un lien de sponsoring mort est un but contre son camp particulier. Puis ignore l’envie de refaire le hub dans un nouvel outil de design. Les utilisateurs voulaient les notes de version.

L’atelier reste sur GitHub. La porte est une page qu’on peut utiliser sans cloner : installer, financer, signaler en privé, et voir qu’une personne est encore là.

Créer ma page — 7€/mois en Pro

Gratuit pour commencer. Pro à 7€ / mois si vous voulez un domaine et le SEO avancé.