プログラミング本の難しさ

演習の準備をしていたら，教科書として使っている本に掲載されているプログラムのバグを発見してしまった．それがこちら．プログラムのとおり実行すると，こんなグラフが表示される．

おやおや？これ何さ．期待されている図は次のようなもの．インフォグラフィクスの事例である．

これ，扱うデータの問題で，書籍の説明が若干不十分だったことによる．筆者は「たまたまうまく動作するデータ」で検証してしまったのであろう．上の「なんだかよくわからない図」を，下の「まともな図」に直すにはどうすればよいか．実はコードの一行，一箇所だけ，手を加えればよいのだが，それも演習の課題にしてみよう．

環境を揃える難しさ

プログラミング指南本を執筆する際に，このような「環境を整える難しさ」を避けられない．とくに，バージョンが変わると仕様がコロコロ変わるような環境は要注意である．

私が過去執筆した某書籍，順を追ってアプリケーションを構築していくという建て付けになっており，当時の院生だったNさんも検証してくれて「これでエラーもなく完璧だ」と自身を持ってリリースした．ところが，すぐにプラットフォームのバージョンがアップデートされてしまい，また，ライブラリのバージョンもいろいろと変わって，書籍の説明どおりにやってもうまくいかないという状況になってしまった．