人力検索はてな
モバイル版を表示しています。PC版はこちら
i-mobile

仕様書のことについて質問なのですが、
仕様書が無い状態でコーディングを行い、ある程度プログラムが
完成した状態で「仕様書書いてってや〜」と言われました。

以下の条件の場合、どのような仕様書を書けば良いと思われますか?
・前提知識のないプログラマが見た際に同等の動きをするプログラムが組める仕様書。
・”仕様書が無い状態”というのは、コーディング前に簡単なブロック図などで
口頭で説明を受けて不明点はその都度指示を仰いで作業してました。
(よってプログラムの動作を示す資料などはほぼ皆無。全て頭の中^-^;)
・始めは「仕様書はコッチで作るから大丈夫」と言っておられたのですが
「ゴメン、時間作れそうにないから仕様書作って」といわれました。

どなたかアドバイスと仕様書制作のためになるページを紹介願います。
仕様書というものを書いたことが無いので今現在非常に不安な気持ちで作成しております。

●質問者: syuzabu
●カテゴリ:ビジネス・経営 コンピュータ
✍キーワード:アドバイス コーディング ブロック プログラマ プログラム
○ 状態 :終了
└ 回答数 : 7/7件

▽最新の回答へ

1 ● matsu911
●10ポイント

http://www.metabolics.co.jp/SoftwareProcess/SRS.html

System Requirements Specifications

このIEEEのテンプレートにしたがって書けば、割と過不足なく書けるとおもいます。

まあ、要らない部分は端折ってもいいでしょう。

◎質問者からの返答

お〜・・・なんか難しい(^-^;)

参考にしてみます。


2 ● albega
●15ポイント

http://www.hatena.ne.jp/1071021766

人力検索はてな - 駆け出しプログラマをやっております。プログラム仕様書の上手なまとめ方の載っているサイトがあれば教えてください。実例に沿って解説してある所が良いです。..

以前の質問「プログラム仕様書の上手なまとめ方の載っているサイトがあれば教えてください」の回答を参照されるのはどうでしょう?


プログラム作成を依頼するほうが要求仕様をまとめていない以上、作った方で作成できるのはプログラムの機能、パーフォーマンスを説明すること(プログラム作成のために説明を受けたことをまとめる)、および想定される範囲の例外処理を記述して仕様書をまとめるしか出来ないでしょう。

◎質問者からの返答

アドバイスありがとうございます。

う〜ん、難しいです。(^-^;)

紹介アドレスから私が欲しい情報は得られませんでした。(T-T)


3 ● maybetrue
●5ポイント

http://segroup.fujitsu.com/sdas/technology/develop_guide/1_caa.h...

ページ移動のお知らせ : 富士通

富士通のドキュメント標準がダウンロードできます。


4 ● thim
●25ポイント

http://www.google.com/search?hl=ja&lr=lang_ja&ie=UTF-8&a...

Google

プログラム仕様書を書けばいいわけですが、そのプログラムの

・入出力は何なのか(入力の前提条件と結果出力の条件は何なのか)

・どういう役割を負うのか(どこまでは責任を負うがそれ以降は別のプログラムに任せるなど)

・異常が起こった場合どう振舞うのか

の詳細が示されていれば良いと思います。

◎質問者からの返答

具体的なアドバイスありがとうございます。

入出力に関してはデータフローで出してました。

その発生条件てのはフローチャートとかで表すのでしょうか?

異常が起こった場合・・・例外処理とかも書くんですねぇ(当たり前か;;)

仕様書の構成も中々難しいです。


5 ● fruitage
●15ポイント

http://www.doxygen.org/

Doxygen

なんとなく形式的に必要だから仕様書を書くだけのような気がします。

最低限の内容でも十分ではないでしょうか?


上記URLのDoxygenでも使って、概要だけでもプラスアルファしておけば満足される可能性大です。

◎質問者からの返答

うぉ、コレ凄いですね。w

うーん、でも求めてるものとは若干違うような気がします。

だけどありがとう。以後自分用資料作成として遣わさせて頂きます。


1-5件表示/7件
4.前の5件|次5件6.
関連質問


●質問をもっと探す●



0.人力検索はてなトップ
8.このページを友達に紹介
9.このページの先頭へ
対応機種一覧
お問い合わせ
ヘルプ/お知らせ
ログイン
無料ユーザー登録
はてなトップ