著者:角 征典 訳
CSV: この書籍の引用一覧をダウンロードできます
CSVというファイル形式でダウンロードできます。このデータをExcelに貼り付けると、表にして手元に記録を残せます。
関数やクラスを文書化するときには、「このコードを見てビックリすることは何だろう? どんなふうに間違えて使う可能性があるだろう?」と自分に問いかけるといい。基本的にはコードを使うときに直面する問題を「前もって」予測したい。
読みにくいコードがあれば、そこで行われているタスクをすべて列挙する。そこには別の関数(やクラス)に分割できるタスクがあるだろう。それ以外は、関数の論理的な「段落」になる。タスクをどのように分割するかよりも、分割するということが大変なのだ。
見た目が美しいコードのほうが使いやすいのは明らかだ。考えてみれば、プログラミングの時間のほとんどはコードを読む時間なのだッ! さっと流し読みができれば、誰にとっても使いやすいコードだと言えるだろう。