La liste citée et ouverte de minimaxir est devenue le manuel des règles cachées de Hacker News

Hacker News se présente comme un simple agrégateur de liens régi par ses Guidelines et sa FAQ, mais l'essentiel de ses mécanismes réels n'est pas documenté : des seuils de karma déterminent discrètement qui peut voter négativement, signaler et parrainer ; les comptes et domaines spammeurs sont shadowbannis, si bien que leurs publications arrivent mortes ; les sujets politiques, les tutoriels et les publications sans URL sont rétrogradés ; les fils trop enflammés sont pénalisés par le logiciel. Les utilisateurs découvrent généralement ces règles à leurs dépens, lorsqu'une soumission est signalée jusqu'à disparaître, qu'un commentaire s'évapore ou que les publications d'un compte cessent d'apparaître.

Les moyens évidents de combler ce manque ne passaient pas à l'échelle : solliciter le personnel est lent, la FAQ omet les mécanismes, et le folklore propre à chaque fil est peu fiable. Max Woolf (@minimaxir), utilisateur de Hacker News depuis 2012, a plutôt rassemblé les preuves éparses dans un README GitHub public, « A List of Hacker News's Undocumented Features and Behaviors », regroupant les fonctionnalités non documentées, les comportements observés et des points d'accès bonus tels que /latest, /classic et /pool.

La liste a gagné la confiance par la discipline de ses citations : chaque entrée renvoie au commentaire du personnel, à l'annonce ou à la page qui la documente, de sorte que les affirmations peuvent être vérifiées plutôt que prises pour argent comptant. Elle invitait toute personne repérant une erreur à la corriger, et elle déclarait à deux reprises n'avoir aucune affiliation avec Hacker News, Y Combinator ou toute entreprise financée par YC, écartant toute apparence de motif intéressé.

L'artefact est devenu la référence. Le dépôt affichait environ 3,8 k étoiles et 117 forks, et lorsque la liste a atteint Hacker News en juin 2020, le fil a recueilli 673 points et 266 commentaires : les lecteurs discutaient ses affirmations, proposaient des entrées encore manquantes comme la suppression des emojis et les fils de commentaires détachés, et le modérateur dang y a participé directement. Le README a continué d'absorber des mises à jour au moins jusqu'en novembre 2022, date à laquelle sa note sur BigQuery couvrait les données jusqu'à ce mois.

Compilez les règles non documentées d'une plateforme avec des liens vers les sources primaires et des corrections ouvertes, et la foule adoptera votre liste comme le manuel

Relier chaque entrée à un commentaire ou à une annonce du personnel rend chaque affirmation vérifiable, si bien que la liste se lit comme une recherche documentée plutôt que comme une rumeur.

Les issues et pull requests ouvertes transforment les lecteurs en mainteneurs, permettant au guide de suivre une plateforme qui modifie ses fonctionnalités sans les annoncer.

Un avertissement bien visible de non-affiliation écarte toute apparence de motif intéressé, ce qui compte pour une communauté méfiante envers la promotion.

Elle comble le manque au moment du besoin : lorsqu'une publication d'utilisateur meurt ou qu'un compte disparaît, le README est la seule carte assemblée des règles cachées.

Quand une institution refuse de documenter ses règles non écrites, rédigez vous-même le guide de terrain : reliez chaque affirmation à une preuve primaire, ouvrez les corrections à la communauté et déclarez tout intérêt.

Selon l'instantané de 2020, le dépôt portait environ 3,8 k étoiles et 117 forks, et le fil Hacker News de juin 2020 — 673 points, 266 commentaires — traitait la liste comme le document de travail des mécanismes cachés de HN : les lecteurs l'ont enrichie de comportements qu'elle manquait encore, comme la suppression des emojis et les fils de commentaires détachés, et le modérateur dang a pris part à la discussion. Le README est resté ouvert aux issues et aux pull requests et n'a cessé de croître, ses notes suivant les fonctionnalités et la couverture des jeux de données au moins jusqu'en novembre 2022. Max Woolf est resté le mainteneur, sous le même avertissement de non-affiliation.