海外の反応
2026年10月11日
【海外の反応】README検証に人を雇ったら絵文字論争に発展
「海外の反応」の記事
英国のブログ「shkspr.mobi」の筆者が、自分のプロジェクトのREADMEを実際に人に読んでもらい、手順通りに動かせるか試すために報酬を払って検証したという体験談がHacker Newsで紹介された。これはUXデザインの「ユーザビリティテスト」とほぼ同じ手法だとする声が相次ぎ、参加者ごとに手順を直していく進め方は厳密な実験とは言えないという指摘も出た。さらに話が広がったのが、READMEに絵文字を使うべきかという論争で、筆者自身は参加者の反応がほぼ半々だったと明かしている。絵文字の多いREADMEはLLMが書いたものに見えるという声も出て、議論は尽きなかった。
自分のREADMEを人に実際に読んでもらうためにお金を払った
出典: shkspr.mobi / 元記事はこちら
2
海外の名無しさん
2026-10-11 13:19
良いREADMEの書き方をまとめた資料がいくつかあるのは知ってる。すごく使えそうなのを見つけて、後で見返せるようにスターを付けたはずなんだけど、今探しても見つからない。誰かいい参考資料を知ってたらこのスレに貼ってくれない？
3
海外の名無しさん
2026-10-11 13:15
これはUXデザインでいう『ユーザビリティテスト』にかなり近い。Nielsen Norman Groupがいい入門記事を出してる: https://www.nngroup.com/articles/usability-testing-101/ こういう話、HNの人たちは興味あるのかな？自分はコーディングとデザインの両方を専攻してた。
20
海外の名無しさん
2026-10-11 13:19
>>3 すごく興味あるよ、リンクありがとう。
4
海外の名無しさん
2026-10-11 13:03
絵文字はさておき、長すぎると思う。READMEは簡潔に、他のドキュメントへの案内板みたいな役割にすべき（LLM向けのLLMS.txtが目指してる方向と同じ）。あとFAQも載ってるけど、FAQって実は問題が多い: https://passo.uno/what-the-faq/
21
海外の名無しさん
2026-10-11 13:12
>>4 リンク先には『FAQが問題になるのは、使い方に戦略が無い場合だけだ』と書いてある。それを根拠に『問題が多い』と言うのは言い過ぎじゃない？
7
海外の名無しさん
2026-10-11 12:04
これって昔は『QA担当を雇ってプロジェクトの穴を探す』って呼ばれてたよな。それが今は『README通りにやらせるために金を払う』になったわけか
23
海外の名無しさん
2026-10-11 12:09
>>7 これはまさにUXのユーザビリティテストそのもの。人に隣に座ってもらって、自分が作った手順を実際にやらせて観察する。時間への対価を払うのはごく普通のこと。ただ通常は参加者ごとに手順を変えたりはしない。でもREADMEを読ませるみたいなニッチな対象なら（不特定多数向けのECサイトの導線とは違って）、厳密さに欠けてもそれでいいのかもしれない
10
海外の名無しさん
2026-10-11 12:26
そうそう。そのまま動かないプロジェクトの多さは異常。Dockerコンテナ化されてるプロジェクトは依存関係の面でまだましだけど、それでも謎の前提条件や呪文みたいな手順が必要になることがよくある
12
海外の名無しさん
2026-10-11 12:51
いい記事だった！ユーザー…じゃなくて雇った人たちと、もっと時間を使うべきだなと思い出させてくれてありがとう（笑）
13
海外の名無しさん
2026-10-11 13:09
それで、うまくいったの？
16
海外の名無しさん
2026-10-11 12:04
絵文字がやたら多いREADMEは嫌い。ノイズが多すぎる
27
海外の名無しさん
2026-10-11 12:12
>>16 まったく同意。なんか子供っぽく見えるし。絵文字は控えめに、意図を持って使われてた頃は良かった。子供の頃の英語の先生がよく言ってたけど、『何事もやり過ぎは良くない』
28
海外の名無しさん
2026-10-11 12:10
>>16 本当にそう。どうしても使う必要がない限り、絵文字まみれのREADMEを見た瞬間にそのプロジェクトから離脱する。絵文字を無視して本当に意味のあるテキストに集中するのに余計な労力がかかる
31
海外の名無しさん
2026-10-11 12:17
>>16 それは興味深い。自分のテストでは、参加者の半数くらいは絵文字を気に入ってて、1人は嫌がってて、残りは特に強い好みを示さなかった。自分は見ると笑顔になるから残してる
29
海外の名無しさん
2026-10-11 12:53
>>16 一瞬で『これLLM生成だな』と思う。長い機能一覧の説明に合わせて絵文字を一つ一つ人間が選んでるとは考えにくい
30
海外の名無しさん
2026-10-11 12:25
>>16 自分にとって絵文字だらけのREADMEは、READMEもプロジェクト自体もLLMが生成したものだという良いサインになる
32
海外の名無しさん
2026-10-11 12:22
>>16 あなたがREADMEファイル自体を嫌ってるわけじゃないと分かるまで、何回か読み直しちゃった。自分もREADMEでの絵文字の多用は苦手
34
海外の名無しさん
2026-10-11 13:00
>>22 『短く簡潔にするのが大抵の場合いい』って話だけど、Goのドキュメントはまさにそれ。初心者の頃は詳しい説明が欲しくなるけど、経験を積むとその簡潔さのありがたみが分かってくる
35
海外の名無しさん
2026-10-11 13:18
>>23 そう、その通り！UXデザインのユーザビリティテストに一番近い。別のコメントでも書いたけど、もっと深く知りたい人にはこの記事がおすすめ: https://www.nngroup.com/articles/usability-testing-101/
37
海外の名無しさん
2026-10-11 12:30
>>24 インストール手順には普通『前提条件』のセクションがある（あるべき）。前提条件のインストール方法まで説明する必要はないけど、何が必要かはリストにしておくべき
44
海外の名無しさん
2026-10-11 12:31
>>37 ちゃんと書いてあるよ – https://gitlab.com/edent/activity-bot/-/blob/main/README.md?…
46
海外の名無しさん
2026-10-11 12:37
>>44 『Adobe Creative Cloudは不要』って一言がいいね
47
海外の名無しさん
2026-10-11 12:34
>>44 元のコメントを見る限り、まだ不完全なように見える
39
海外の名無しさん
2026-10-11 12:48
>>24 良いREADMEは大体、対応するOSが既に用意されていることを前提にしつつ、そこから動く環境を作るまでのコマンドを一通りまとめてくれてる感じがする
40
海外の名無しさん
2026-10-11 12:28
>>24 前提条件について一言二言書いておいても損はない。『このマニュアルはLinux/BSD、Cコンパイラ、GNU Make、テキストエディタがあることを前提としています』みたいに
41
海外の名無しさん
2026-10-11 13:10
>>24 そんなに難しい話じゃない。自分が書いたインストール手順書には全部『前提条件』のセクションがあって、必要なものをそこに書いてる
42
海外の名無しさん
2026-10-11 12:30
>>28 これは、見出しにまで絵文字を付けてくる大多数のREADMEよりはまだましだった。少なくともこの絵文字は隣の項目をちゃんと表してるように見える。見出しにロケット絵文字をドーンと置いて、本文中に関係ない絵文字をあちこちバラ撒くようなやつとは違う
43
海外の名無しさん
2026-10-11 12:27
>>31 自分にとっては、あなたが削除したジョークについて書いていたことと似てる。絵文字は気を散らすだけで、実際には面白くない。こういう絵文字の使い方は、使い古されたミームみたいに見える。プロジェクトがちゃんと動いて望んだ通りに機能するという本質的な良さで人を笑顔にできる方がいい
45
海外の名無しさん
2026-10-11 12:51
>>38 なんで`git clone`で止めるの？ `apt install git`とか、各OS向けの同等コマンドまで書かないのはなぜ？
48
海外の名無しさん
2026-10-11 12:56
>>45 自分がドキュメントを書くときは、最初にシリコンをどうトランジスタとして使えるかの説明から始めるよ
49
海外の名無しさん
2026-10-11 13:01
>>48 まあ自分は超新星で自家製シリコンを作るところからやってるからね。『ゼロからアップルパイを作りたいなら、まず宇宙を発明しなければならない』ってやつだ
この話題の背景と論点
READMEのユーザビリティ検証は、UXデザインの分野では一般的な手法だが、ソフトウェアのドキュメント作りにそのまま応用した例はあまり知られていない。スレ内で指摘されている通り、参加者ごとに手順を修正していく進め方は厳密な実験とは言えないが、不特定多数向けのサービスとは違い、少人数のニッチなプロジェクトでは現実的な妥協とも言える。もう一つの論点である絵文字の是非は単純な好みの問題だけではない。近年、LLMが自動生成するREADMEは見出しごとに絵文字を多用する傾向があり、絵文字の多さが「AI生成っぽさ」のサインとして受け取られるようになっている。この背景はスレ内では断片的にしか触れられていないが、絵文字論争が見た目の好み以上に広がった理由として押さえておきたい点である。
※本記事は海外掲示板 Hacker News のスレッド「I paid people to try and follow my README 」から抜粋し、編集部で日本語に意訳したものです。訳文の責任は当サイトにあります。
続けて読む（海外の反応）
この記事のリアクション
😆 おもしろい 0 😮 びっくり 0 😢 かなしい 0 👍 わかる 0 😠 ひどい 0
まだコメントはありません。