自分のためにドキュメントを書く | kino's blog

kino's blog

マーケティング業界に働くエンジニアです。
ブログの方向性はこれから決めていきます。
日々の生活の中での発見、進歩、気づきをアップしていきます。

商売柄ドキュメントを書くことを求めらるのだが、
最もドキュメントを書くの嫌がる人種の集まりでもある。

なぜならドキュメントなんか書くより
プログラム書いた方が早いから
というのは一理ある

たしかに繰り返しとか、わかりきったことを
日本語で書くくらいなら
プログラムで書いた方が紛らわしくなく
もどかしくなく、わかりやすい

一方で少し複雑な処理とかになると、
部分から入ると迷路にはいる。
そんな時は全体や抽象から入った方がいい

その場合は寧ろ文書で書いた方が
あたまの整理が早くつく

それは人に説明するというよりも、
現在の自分の頭の中を整理する、
あるいは将来の自分に伝えるための意味が強い

そう考えると体裁を整える必要も無く
気楽に文書を書き始めることができる

それに少し手を加えれば人の説明の補助にも使える

このブログの書き込みも自分の考えをあぶり出すため
これから会う人に自分の考えの遠隔をつかんで貰うため