見出し画像

IT エンジニア日記 ~ドキュメントを書く人は?~ -2024/09/24-


日記

どうも。求められてる答えがわからない仕事には身が入らない clown です。

ゴールがわからないとどこまでやればいいのかわからないし、必要な情報がわからないから仕事のしようがない。ってのが自論。異論は認める。

そんな僕。

休みなくドキュメントを書いている。
ドキュメントって、位置付けによって書く人が違う方が良いという話。
要件定義なら上流のマネージャーやリーダーが書いた方が成果が出やすいし、設計書やテストチェックリストならエンジニアが書いた方が成果が出る。
なんでかと言えば、いろいろな人を巻き込んで調整したり決めたりするのは上流にいる人が担うわけで、要件定義、できれば基本設計くらいまではそういう人が書くと話が早い。
決まったことを実現するためには、下流にいるエンジニアの方がソースを読む力、あるいは機会が多いと思うので、基本設計から詳細設計、テストチェックリストはエンジニアが書いたほうが良い仕事になると思う。

適材適所で仕事すれば効率は良くなるし、チームワークも産まれる。
なので、全部エンジニアに丸投げするのはどうかと思ってる。いま、丸投げされててキツいって言いたいだけ。しかも正解がわからないのに、それで合ってるの?とか訊かれるので、ホントキツい。


支援のお願い

本記事は全文を無料でお読みいただけますが、気に入ったらご購入いただけると嬉しいです。
また、下記リンクのご支援をいただけると励みになります。


掲げている使命

好きとスキルを駆使して、心身と経済が豊かな日本社会を創造する

いま、目の前で困っていることがある方のために僕の「好き」と「スキル」がお役にたつかもしれません。
こちら(↓)の自己紹介で僕の得意を書いていますので、お困り事のある方は、コメントをいただけるとありがたいです。


素材引用元

アイコン

見出し

この記事が気に入ったらサポートをしてみませんか?