外注さんにあるマイコンのソフトを作成してもらうために仕様書を書くことになりました。
各機能ごとに章立てして、その中に、
(1)機能の概要
(2)画面デザイン、
(3)各イベントに対する動作など
を記述しているのですが、(3)についてどうもうまく整理された形で表現できません。
Wordを使用しているのですが、箇条書きにするとだらだら羅列してあるだけで、本当にそれで全てが網羅されているのかわからない、かといって、縦(イベント)×横(状態)の一覧表にすると、横(状態)が膨大な量になり収集がつかなくなってくる...
文や表でななく、フローチャートやPADで記述した方がいいのではとも思ったのですが、みなさんはどのように表現されていますか?
お知恵を貸して下さい。
No.1ベストアンサー
- 回答日時:
たぶん、この仕様書がわかりやすく正確に書かれているなら、それに忠実に従って造られたソフトもわかりやすく正確なものになるでしょう。
すなわち、ソフトの出来如何はこの仕様書にかかっていると言ってもいいのではないですか。私はWordがあまり好きではないけど、リンクを多用すると思います。
たぶん、ソフトは階層構造だろうけど、図示して、一覧できるようにします。その図の各項目にリンクを貼り付けて、その説明書きにジャンプするようにしますね。全体構造と各部分説明を分離します。
それで、リンクをどんどん増やしていきます。そうすれば、同様にできあがったソフトにおいても各機能がリンクでつながるわけで、使いやすいものになるのじゃないですか。単純な階層構造の欠点は、横のつながりがないことです。
ということで、仕様書は印刷物では困りますね。リンク機能が活かせるものになると思います。
ご回答ありがとうございます。
最終的に印刷物としても残すことが習慣になっているのですが、やはりそれだけでは限界がありますね。
目的として、
・それでシステムの仕様が把握できる
・それでコーディングができる
ことがまずはあげられるのですが、
Wordによる仕様書自体を機能ごとにリンクで階層構造化するというのは大変参考になりました。
ただその機能の説明の中で、(3)のような説明をどのように表現したらいいのかが、まだイメージできていません。
whitepepperさんはWordが好きではないそうですが、何をお使いになっていますか?
No.3
- 回答日時:
》whitepepperさんはWordが好きではないそうですが、何をお使いになっていますか?
Wordの良いところは、多くの人が使っているので、文書ファイルのやりとりが楽です。その他にこれといった良い点は見いだせません。
それで、目的に合わせていろいろ使います。もちろん好きなソフト、よく使うソフトというのはあるけど、何でもかんでもそれを使うのは正しくありません。数え切れないほどソフトが造られているのがWindowsマシンです。使用目的に合わせてそれを選んで使うのが当たり前だと思います。
こういう仕事に向いているのがアウトラインプロセッサーですね。フリーソフトでも良いのがたくさんあります。ただ、最終的にWordの文書にしなければならないのでしたら、チト不便かもしれません。中でも、リッチテキストフォーマットやHTMLで出力できるものもありますから、それをお使いになればいいでしょう。
大事なことはツールではありません。あなたの頭の中でそのソフトの機能がきちんと整理されているかどうかです。
参考URL:http://www.forest.impress.co.jp/library/storyedi …
おっしゃるとおり、最終的な目的はツールではなく、自分の考える仕様を如何に正しく伝え、誤解なく理解してもらうことができるかということにあります。
ご紹介いただきましたツール、参考にしたいと思います。
ありがとうございました。
No.2
- 回答日時:
こんばんは。
参考程度に聞いてください。UMLという言語をご存知でしょうか?
たぶん近い将来ISO(国際標準化機構)に採用されることになるであろう、統一モデリング言語です。
UMLを利用することによって今まで各システムごとにばらばらだった設計書が、誰が作っても同じ、つまり標準化されるようになります(しかも全世界的に)。
しかもUMLの優秀なところは、システム構築側だけでなく、システムを使用するユーザー側にも同じ設計書で説明ができることです。
ダイアグラムで設計されていますので、設計者が見てもエンドユーザーが見ても視覚的にうったえるのですネ。
ご質問の内容であれば、UMLで言うところの「ステートチャート図」というのがあてはまるでしょう。
普通Visioを使ってダイアグラム(フローチャートですね)を描いて行きますが、Wordでもなんら問題はないと思います。
一度書店およびネットで参考程度にのぞいてみてはいかがでしょうか?
・設計・コーディング・プレゼン
が一度に出来る方法です。
(オブジェクト指向のシステムを構築するための言語ですが他のシステムにも利用できます)
ご参考まで。
UMLは以前少し勉強しかけたことがあるのですが、それだけで終わってしまいました。自分が携わっているシステムがCによる非オブジェクト指向のものであったため、UMLをどのように使っていけばよいか分からなかったためですが、もう一度見直してみようと思います。
ありがとうございました。
お探しのQ&Aが見つからない時は、教えて!gooで質問しましょう!
似たような質問が見つかりました
- Excel(エクセル) Excelで校閲をする方法はあるでしょうか(取扱説明書への掲載禁止用語の確認) 3 2022/06/11 22:51
- 英語 会社で英語を使うことになっての英語の勉強方法 5 2022/07/03 11:49
- HTML・CSS ホームページをちょっと加工する程度の無料または古くて安く購入できる作成ソフトを教えてください 5 2022/12/16 12:17
- 日本語 意味とは何か、どこにあるのか? 16 2022/04/09 11:44
- 発達障害・ダウン症・自閉症 私は幼い頃から周りの子と変わったところがあり社会人になってからも仕事が長続きせず上手くいかないことだ 3 2022/08/26 13:24
- CAD・DTP 「機能ブロック図」の描画用フリーソフトを教えてください 1 2022/09/23 16:12
- WordPress(ワードプレス) ワードプレスで、投稿一覧ページにタグを表示する方法 投稿につけたタグを、記事一覧ページにもカテゴリと 1 2023/05/10 21:41
- 会計ソフト・業務用ソフト 会計ソフトを探してます。 4 2022/08/17 08:35
- その他(IT・Webサービス) ホームページにカウント数を表示する 2 2022/10/28 10:37
- Word(ワード) Wordの目次作成についてです。 卒業論文で目次を作ることになりました。 本文は「見出し」の機能を使 1 2023/01/17 11:26
関連するカテゴリからQ&Aを探す
おすすめ情報
デイリーランキングこのカテゴリの人気デイリーQ&Aランキング
-
DVD ファイナライズだけをする...
-
平面図を立体に起こすソフトを...
-
Macで3次元モデルの展開図を生...
-
jw-CADでのヘロンによる求積に...
-
おすすめの建築パース用のソフ...
-
DOS版CADデータ(拡張子m...
-
RS232Cを経由してEXCELに...
-
64ビット機で32ビット時代のHDD...
-
1番良いと思う3DCG作成ソフト...
-
3Dステージのモデリングについて
-
収納品が入った押入れのパース...
-
服のシワがシミュレーションで...
-
建築パースのソフトについて
-
平面図および横断図からの追加距離
-
B's Recorder Gold Basicでプリ...
-
レンダリング専用PCを
-
小規模事業所におすすめの給与...
-
AutoCADとME10はどちらがいいか?
-
拡張子mdlの読み込み
-
3DCGの漫画の描き方について
マンスリーランキングこのカテゴリの人気マンスリーQ&Aランキング
-
DVD ファイナライズだけをする...
-
AutoCADとME10はどちらがいいか?
-
.dat ファイルの開き方
-
イラストレータをCAD代わりにで...
-
RS232Cを経由してEXCELに...
-
駅の構内図の作成ソフトを教え...
-
イラストレーター10で面積を測...
-
拡張子「.OL」とは何のデータで...
-
vb.netでExcelみたいに管理画面...
-
拡張子mdlの読み込み
-
64ビット機で32ビット時代のHDD...
-
大きなサイズのデータを分割し...
-
3Dステージのモデリングについて
-
AutoCADで製作した3Dモデルを実...
-
3DCADについて
-
PDFの用紙サイズを変更するには?
-
jpegを漫画のように2ページずつ...
-
★AUTOCADで画像ファイルを貼付...
-
パソコンの買い替えについて
-
造園のソフトありますか?
おすすめ情報