説明ないしドキュメンテーション

よくこの類の能力を求められるが、私は非常に苦手。
まず、自分の常識と世間の常識の違いに躓く。これが一番大きい。
次に、そもそも説明に使える語彙が少ない。で結局テクニカルタームを多用せざるをえなくなり、先の問題を併発する。
最後に、図の構成能力が無い。大抵、適当なルールを決めて機械的に生成。
論文等で鍛えられたはずだが鍛え方が足らなかったらしい。

業務改善というか、あまりにも面倒な作業だったので、工事立会いで暇なときに適当にコード書いた。同じ作業をしている先輩社員がいるので、紹介したところ話が大きくなり、課長にドキュメントの提出を求められた。そもそも自分が使うことしか考えてないので、設定の変更はコードの変更を意味するようなコード。一応それなりのドキュメントをでっち上げられたつもりで、提出したら大量のダメだし。

以下愚痴。
CやVBの知名度は課内で普通にあるみたいだが、Pythonというかスクリプト系言語の知名度がまったく無かった。ライブラリという単語すら要説明なのはびっくり。PCが広く普及したのは良いが、計算機関連の知識はまったく広まっていない。PCは汎用計算機のはずなのだがまったくそうは見られてないよなあ。