社内ＳＥの日常、説明書の誤記

2022年4月27日 19:49

とあるプログラムを改良している時のことです。
このプログラムは、連続した数値をファイルに出力する機能を持ちます。

改良前に動作を確認したのですが、明らかに異常な数字をファイルに出力しています。
現状では誰からも異常が報告されていないので、何が原因なのか探ってみることにしました。

ソースコードを含めて動作を検証してみると、プログラムの説明書が間違っていることが分かりました。
プログラムを起動するときに必要な設定に関する記述が間違っていて、説明書に書かれてある通りに動かすと、別の数値が出力されるのでした。

プログラムを使っている現場では、設定を変えることが無いので、誰も気が付かない問題なのです。
プログラムと一緒に説明書の誤記を修正することにしました。

誤記、Oを0と書き間違える人間らしい間違いです。
こういう単純だけど見つけにくい問題、数年に１回ぐらいは遭遇します。

遭遇頻度が低いので、原因を特定しにくい問題かもしれません。
私がこのプログラムをゼロから設計する立場なら、設定はアルファベット１文字ではなく、機能を意味する単語にします。

いいなと思ったら応援しよう！