とある技術書を読んでいたところ、あるサンプルコードが気になった。
たしかにサンプルコード自体はそこに書かれていた目的通りの動作はする。しかし動作し終わったあとの処理がまずい。このままではバグが発生する原因となる。
これは良くないなぁと思いながら読み進めていたところ、その章の最後でこの問題の指摘があった。つまり著者も最初から分かっていたわけで。しかし、そこにはコードは無くて文章で書かれているのみ。
これはまずいでしょう。サンプルコードにはちゃんと対処したコードを書いておいて、その場では説明しなくても後で説明すると一言書いておくとかしないと。