マジレス希望

なぜプログラマやSEって「マニュアル」を嫌がるのか？嫌がられない方法は？

解決済

質問者：s_end
質問日時：2024/08/23 17:05
回答数：2件

質問要旨
タイトルの通り

質問詳細
仕事でマクロプログラムやごく簡単なWindowsアプリを作ってもらうことがあります。
そのときに、プログラマやSEに
「マニュアルを作っておいてください」
というと、ものすごい拒絶反応を示されます。

「え！　聞いてないよ！」
「マニュアル作りは業務の範囲に含まれません！　絶対にできません！」
「それをやるなら別料金が発生しますけど、よろしいですよね！！」
ってな感じの強烈な拒否反応です。

別にこちら側は秀和システムや技術評論社が出しているような「できる！シリーズ」「わかる！シリーズ」のような、緻密でどんな細かいことも書いてある商業ベースの印刷物を作ってくれ、といっているわけじゃありません。

※１　テキストファイルで
「１　アプリを起動します
　　　この時、予め指定されたフォルダにデータファイルが入っていることを確認して次に進んでください
　２　コンソール画面のAボタンを押下します
　３　処理が始まります。処理の最中はウィンドウを最小化して他の作業をしても構いません。
　４　処理が完了すると終了を示すメッセージボックスが表示されます
　５　途中でエラーになった場合、エラー内容は以下の3種類に分類されます。
　　５－１　Xエラーの場合
　　５－２　Yエラーの場合
　　５－３　Zエラーの場合
　６　アプリが終了したら規定のフォルダに結果ファイルとログファイルが排出されます。」
という程度の操作説明書をつけて欲しい、というレベルの要求です。

これを説明するとSE,プログラマは
「ああそうですか、そのぐらいなら無償で作りますよ」
と言います。

果たしてSE,プログラマという人たちは
「マニュアル作ってね」
というと
「秀和システムや技術評論社が出しているような「できる！シリーズ」「わかる！シリーズ」のような、緻密でどんな細かいことも書いてある商業ベースの印刷物を作ってくれ、だって！
　そんなことできるわけねえじゃん！」
とでも思うのでしょうか？

これは私が使っている「マニュアル」という単語の使い方が誤っているのでしょうか？
また、SE,プログラマに拒絶反応を起こされずに、マニュアルを作ってもらうにはどうしたらいいでしょうか？
※１をそのまんま言えば良いのでしょうか？　でもそれでは長ったらしいし、そもそも言葉というのは長ったらしい説明をたった一言でいうから言葉なんですよね。
じゃあ、※１はマニュアルではなくて、何なんでしょうか？

詳しい方、教えて下さい。

通報する

この質問への回答は締め切られました。

質問の本文を隠す

回答 (2件)

ベストアンサー優先
最新から表示
回答順に表示

No.1ベストアンサー

回答者： naktak
回答日時：2024/08/23 17:30

そうです。

マニュアルとは体裁が整えられており、しっかりと間違いのない資料を作るというものが念頭に挙がってきます。
エラーについても、こういう文面のエラーが出た場合はこういうことが原因だからこうしないといけない、といった懇切丁寧な情報が求められると考えます。

それには相応の工数がかかります。
当然原価が発生したら、当初の見込みから外れます。
顧客がいるようなものであれば粗利も削ることになります。

あなたが仰っているのは、
「箇条書きのテキストでいいから操作手順を用意してくれ」
という表現で伝えた方が無難でしょう。