minimaxirの引用付き公開リストが、Hacker Newsの隠れたルールの手引書になった

Hacker Newsは、ガイドラインとFAQに覆われた単純なリンクアグリゲーターを装っているが、その実際の仕組みの大半は文書化されていない。カルマのしきい値が、誰がダウンボート、フラグ、vouchを行えるかを静かに制限する。スパムアカウントやスパムドメインはシャドウバンされ、投稿はdead状態で届く。政治、チュートリアル、URLのない投稿はランクを下げられる。過熱したスレッドはソフトウェアによって重みを下げられる。ユーザーは通常、投稿がフラグで殺されたり、コメントが消えたり、アカウントの投稿が表示されなくなったりして、これらのルールを痛い目に遭って学ぶ。

この隔たりを埋める明白な方法は規模に対応しなかった。スタッフに尋ねるのは遅く、FAQは仕組みを省いており、個々のスレッド上の伝聞は信頼できない。2012年からのHacker NewsユーザーであるMax Woolf（@minimaxir）は代わりに、散在する証拠を一つの公開GitHub README「A List of Hacker News's Undocumented Features and Behaviors」に集め、文書化されていない機能、観察された挙動、そして/latest、/classic、/poolといったおまけのエンドポイントを分類した。

このリストは引用の規律によって信頼を得た。各項目はそれを文書化したスタッフのコメント、告知、ページへリンクしているため、主張は盲信されるのではなく検証できる。誤りを見つけた誰からの訂正も歓迎し、Hacker News、Y Combinator、またはYC支援企業のいずれとも無関係であると二度宣言し、動機の疑いを一切取り除いた。

この成果物は参照先となった。リポジトリは約3.8kスター、117フォークを示し、リストが2020年6月にHacker Newsに到達すると、スレッドは673ポイント、266コメントを集めた。読者はその主張に異議を唱え、絵文字の除去や切り離されたコメントスレッドなど、まだ欠けている項目を提案し、モデレーターのdangが直接関与した。READMEは少なくとも2022年11月まで更新を取り込み続け、その時点のBigQueryに関する注記はその月までのデータを扱っていた。

文書化されていないプラットフォームのルールを一次資料へのリンクとオープンな修正とともにまとめれば、群衆があなたのリストを手引書として採用する

各項目をスタッフのコメントや告知にリンクすることで、あらゆる主張が検証可能になり、リストは噂ではなく文書化された調査として読まれる。

オープンなissueとプルリクエストが読者をメンテナーに変え、告知なしに機能を変えるプラットフォームをガイドが追跡できるようにする。

目立つ無関係の免責事項が動機の疑いを取り除く。これは宣伝を信用しないコミュニティにとって重要である。

必要とされる瞬間に隔たりを埋める。ユーザーの投稿が死んだりアカウントが消えたりしたとき、READMEは隠れたルールの唯一まとめられた地図である。

組織が自らの不文律を文書化しないなら、自分で現場の手引書を書け。あらゆる主張を一次証拠にリンクし、訂正をコミュニティに開き、利害関係を否認せよ。

2020年のスナップショットまでに、リポジトリは約3.8kスターと117フォークを抱え、2020年6月のHacker Newsスレッド（673ポイント、266コメント）は、このリストをHNの隠れた仕組みの作業文書として扱った。読者はまだ見落とされている挙動、たとえば絵文字の除去や切り離されたコメントスレッドでそれを拡張し、モデレーターのdangが議論に関与した。READMEはissueとプルリクエストに開かれたままで成長を続け、その注記は少なくとも2022年11月まで機能とデータセットの範囲を追跡した。Max Woolfは同じ無関係の免責事項のもと、メンテナーであり続けた。