あなたの文章は読めない
この記事「Your Shit Is Unreadable」は、技術文書やコードコメントにおけるわかりにくい表現や不適切な書式を批判的に指摘し、読みやすく伝わりやすい文章を書くための実践的なアドバイスを提供している。簡潔で明確な表現の重要性を強調する内容。
背景メモ
- この記事が批判する「Lisp系記法（LCN）」とは、Lispプログラミング言語に代表される、関数名を前置し括弧を多用するスタイル（例: `(defun square (x) (* x x))`）のこと。著者はこれを「誰も読めない」と断じ、読みやすさを重視した記法を擁護する。
- 背景として、Lisp（1958年開発）は長らくAI研究や一部のハッカー文化で愛用されてきたが、括弧の多さや前置記法が一般のプログラマには不評で、「Lispは読めない」という嘲笑は数十年にわたり繰り返されてきた。
- しかし近年、Clojure（Lisp方言）やElixir（関数型言語）の台頭、さらに「コードは書くより読む時間のほうが長い」という格言の浸透により、可読性論争が再燃。Lisp擁護派は「慣れの問題」「ツールで括弧は色分けできる」と反論する。
- 本記事は、この長年の構文論争に新たな一石を投じる内容。技術コミュニティでは「見た目の美しさ」vs「伝統的記法の利点」という不毛な対立に陥りがちだが、著者はユーザビリティ研究の知見を引きながら、あくまで「読む人の認知負荷」を基準に論じている点が特徴。