要件定義書をパワーポイントで作るのはアリですか？

Question

入社した会社が、要件定義書をパワーポイントで書いて納品してたんですが、これってアリですか？

要件定義書って、契約書とかと同じ"ちゃんとした"ドキュメントの一種だと思うので、プレゼンみたいにパワーポイントで書くことに違和感を覚えたんですが、みなさんの周りでは、パワーポイントで書くのが普通ですか？

Answer 1

要件定義の意味を考えてください。
フォーマットや表現に使用するアプリケーションに縛りはありません。

Comments

[退会済みユーザー]

法的な縛りはないですけど、たとえば巻物に書いたり小学生が持ってるような自由帳に書いたりは常識的にあり得ないですよね。そういう意味です。

[退会済みユーザー]

常識で考えると、要件定義ができる（双方で認識の相違が発生しない）アプリケーション（表現方法）を優先すべきです。
むしろアプリケーションに拘って、要件が定義できなければそのほうが問題です。

Answer 2

ちゃんとしたドキュメントとは何でしょうか。
何を使って作るとちゃんとしたドキュメントになるのでしょうか。

おそらく、発注の契約で納品書類の種類やフォーマット等を規定していると思います。そのフォーマットに合致しているものが「ちゃんとしたドキュメント」だと私は思いますよ。
仮に規定がない場合は契約の外の話なので自由にフォーマットを選んでいいと思います。

Comments

[退会済みユーザー]

〉ちゃんとしたドキュメントとは何でしょうか。
契約書がパワーポイント資料だったらおかしいと思いませんか？何も思わない人は思わないんでしょうけど、私は「ん？こいつ変なことしてきたぞ」と思います。

[_Victorique__]

だったらナシで良いのでは？
yonaさんはちゃんとしたドキュメントの自分なりの定義を示していますのでそれに納得できないのならそれはナシということで良いと思います。

[yona]

あなたはどのような形式のドキュメントできたら「ちゃんとしたドキュメント」だと思いますか？
特定のフォーマットではなくとも、どのような特徴を持つべきかは説明できると思うので質問に追記をお願いします。

[退会済みユーザー]

@_Victorique__
そういう「何が正しいかは一人一人違う」的な答えでなくて、業界の原則や一般常識が知りたいです。

「パワーポイントの要件定義書は現場で普通に使われてますよ。広く普及してる文化ですよ」という回答でもいいんです、それが事実なら。

[yona]

あなたの会社と取引会社の間では要件定義書をパワーポイントで書くことが一般的なようです。ここで答えを求めるよりは会社の上司に質問をした方がいいですよ。

また、もっと広い範囲での一般的な答えはおそらくありません。いろいろな会社のフォーマットを見ましたが千差万別です。
あなたが回答になっていないというscsiさんの回答が、一番あなたの理想の答えを知る方法ですよ。

[yona]

IPAにサンプルがありますね。
参考までに
https://www.ipa.go.jp/sec/tool/ep/ep2.html

Answer 3

これってアリですか？

双方が合意の上であれば、アリだと思います。

みなさんの周りでは、パワーポイントで書くのが普通ですか？

普通とまでは言いません(私の周りではWordが多いかもしれません)が、PowerPointのものもたまに見かけるような気がします。
普通といえるほど多数派ではないがさほど違和感はない、というところです。

Answer 4

答えがなくプログラムとも関係がないアンケートはアンケートサイトにでも投稿するのがいいかと思います！

Comments

[退会済みユーザー]

では、回答になっていない投稿はどこへ書くのが適切なんでしょうか？

Answer 5

パワポがちゃんとしてるかどうかはさておき、
そもそもOffice製品がダメなんだよねぇ…
読むに耐えない糞XMLを吐き出す辛い様式をzipで包むとか世代管理させる気ないでしょ。

かといって、MarkdownやHTMLは環境によって全然見え方違うし体裁整えるの超絶辛い。
PDF？あんなの提出直前にプリンター代わりに吐き出す出力様式でしかないでしょ！
他の様式はマイナーだったり専用のソフトが必要だし……

ご覧の通り、減点方式で考えると思いつく選択肢はほぼ全て却下になってしまう。

---

提出する前にどのドキュメントも全てPDFに変換出来るので体裁を取り繕う事は出来る。
なので各様式の特徴から良い所を見ていこう

• Word：

メリット：1ファイルで自力世代管理が出来る、ドキュメントを作る為に存在するだけあって隙が少ない。
デメリット：機械で動的に作るのが苦手、画像や図形の取扱が下手くそ

• PowerPoint：

メリット：画像や図形の取扱が上手いので、絵を描いて説明する要件定義とは用途が合う
デメリット：機械で動的に作るのが苦手、文章書かせると弱い

• HTML (+ Markdown)

メリット：機械で動的に作るのが超絶得意、Git等で世代管理が出来る
デメリット：時間がかかる、多くのファイルが密集するのでファイル管理も技量(エンジニアとしての才能や技量が必要)

• Excel：

メリット：扱えるSIerさんが多い、営業等の非エンジニアの人も得意だね
デメリット：他全部だよ畜生、方眼紙は作らないでくれよな～頼むよ～

• 他：メリット・デメリット色々。客に提出する前にPDFにしてね

要件定義の目的は、
要件を描いてお互いに「うん、これで一緒に作っていきましょう！頑張ろうね！」って納得する事。

仕事の基本は早く目的に沿うものを出すこと。
納期過ぎて100％の物出すくらいなら、納期前に80％が出る方がまし。
目的さえおさえておけば体裁とかは後で相談しながら整えても良いわけだね。

上記の内、私が個人的に選ぶとすればパワポ・HTML・Wordの順かな。
こういう様式を多く作る会社なら今後も見据えてHTMLで量産出来るよう自動化に注力したいかもしれないね。
でも1回限りなら画像や図形をゴネゴネするのが得意なパワポで出す人は多いと思うよ。
…というわけで、質問者さんには申し訳ないけどパワポを支持する声が多かったわけだね。

Answer 6

十分有りでしょう。

世の中には、表計算ソフトで仕様書を作っている会社ですら、多数あるようです。