お悩みその30 私のコードを他人が理解できない（28歳 男性 サーバサイドエンジニア）：心はバグだらけだにゃあ（3/4 ページ）

[杉山慎，＠IT]

理解させた気にさせるトリック

　他人の心をハックするコードはどう書くのか？

　単に読みやすいコードというわけではないのだ。「読みやすいコードの書き方」のような本は十分に役に立つ。自分も他人も読みやすくなるし、不具合を減らすことにも効果的なので、読んでおいて損はないのだ。しかしながら、「読みやすいコード」と心をハックする「理解した気にさせるコード」は異なる。さらには「読みやすいコード」かつ「理解させた気にさせるコード」は両立する。もちろん「理解させるコード」がベストではある。

　この手法は、コードの書き方を全く変えないというわけではない。コードの骨子であるポリシーはそのままに、見た目の化粧を施して受け入れやすくさせるイメージだにゃ。「読みやすいコード」は他の記事や本に任せるとして、「理解させるコード」または「理解させた気になるコード」を書く手法を説明するのだ。