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

書いて楽しい、見て楽しい、しかもわかりやすい仕様書の書き方ってどんなものがあるでしょうか?
私は家電のソフト屋ですが、あまり堅苦しく書かれても読みにくいし・・・。
ウチではこんな試みしてるよー なんてお話もあれば聞かせていただきたいです。


●質問者: s
●カテゴリ:コンピュータ 家電・AV機器
✍キーワード:お話 ソフト 仕様書 家電 楽しい
○ 状態 :終了
└ 回答数 : 4/4件

▽最新の回答へ

1 ● fumikef
●23ポイント

ソフト屋ということなので、おそらくプログラム仕様書全般のことを仰ってるんだと思いますが、間違っていたらすみません。


プログラム仕様 - Wikipedia


上の Wikipedia の古典的な分類を例にするなら

などがあると思うのですが、このどれについても使えて、奇麗にまとまって見えるように書くポイントとして私が気をつけていることは、以下のようなものです。

(よくある話しかもしれませんが・・・)



ヨコですが「しょうがない」は、漢字にすると「仕様が無い」です。

更にヨコですが「くだらない」などの意味で使う「しょうもない」も、漢字にすると「仕様も無い」です。


ただし、私は、誤りなく伝えることができる書き方をする事こそが大事だと思います。できるだけ短く書こうとして、その為に別の意味にも読めてしまう書き方にならないように注意が必要ですね。


仕様書は、依頼主への提出する為だけの物ではなくて、後で運用・保守・改訂作業を行う際に無くてはならない物ですから。(ソフト屋さんでしたら判ると思いますが)特に、後から忘れた頃にやってくる改訂で、仕様書が揃っていないと非常に苦労することになります。

◎質問者からの返答

誤りなく伝えるために、読む気にさせるのも重要なのかなぁと思ってます。

運用・保守・改訂作業がまたしんどいです。なんとか楽しい作業にしたいですよね。


2 ● どんジレ、どんさん
●23ポイント

こんにちは。


仕様書の書き方って,習いました? - 日経エレクトロニクス - Tech-On!

http://b.hatena.ne.jp/entry/http://techon.nikkeibp.co.jp/article...

もうご存じかもしれないですが、上記が参考になるかと思い、紹介させていただきます。

また、簡潔に説明することも、あるていど量のある説明をすることにも使える点で、CPAN http://search.cpan.org/ のフォーマットが見易いのではないだろうかと考えました。専門家の方にご紹介するのは釈迦に説法で気が引けるのですけれども、よろしければご参照下さい。



以上、参考になれば幸いです。


3 ● AZUY
●22ポイント

こんにちは

* 基本仕様

* 機能仕様

* 詳細仕様

該当箇所の機能を上から順番に読めば仕様を理解できると言う書き方が、

わかりやすい仕様書だと思います。

状況にあった詳しさをで抑えられてるほうが、理解もしやすいですし・・。

=>書いて楽しい、見て楽しい

私もこれに関心があります。

いままで、書いて楽しいと思ったこともないし、

見て楽しいと思った仕様書もありません。

◎質問者からの返答

>見て楽しいと思った仕様書もありません。

やっぱりないですかぁ。

どこかにはあると思うんですよねぇ


4 ● dachii
●22ポイント

こんにちは。

楽しいがポイントということですので、小説風に書くのはいかが?

小説ぽく、いきいきと記述。仕様書のユースケースや機能説明といったところではよいかも・・。

もとはJoel on Softwareからヒント。機能仕様書サンプルのシナリオのところです。

http://japanese.joelonsoftware.com/PainlessSpecs/WhatTimeIsIt_Jp...

あとは、ゆるーい手書き風フォントをいれて、テクニカルノートやメモ、ふきだし満載の仕様書にするとか。

#どっちもチャンスをうかがっているところで、まだ試したことはありませんが:-)

◎質問者からの返答

Joel on Software は私も好きです^^

>あとは、ゆるーい手書き風フォントをいれて、テクニカルノートやメモ、ふきだし満載の仕様書にするとか。

全部マンガでかくとか考えたことありました:-) 絵を多様すると読むための敷居が下がる気がするんですよね。

子供でもわかる仕様書みたいなの 作れないかなぁ

関連質問


●質問をもっと探す●



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