私は家電のソフト屋ですが、あまり堅苦しく書かれても読みにくいし・・・。
ウチではこんな試みしてるよー なんてお話もあれば聞かせていただきたいです。
ソフト屋ということなので、おそらくプログラム仕様書全般のことを仰ってるんだと思いますが、間違っていたらすみません。
上の Wikipedia の古典的な分類を例にするなら
などがあると思うのですが、このどれについても使えて、奇麗にまとまって見えるように書くポイントとして私が気をつけていることは、以下のようなものです。
(よくある話しかもしれませんが・・・)
ヨコですが「しょうがない」は、漢字にすると「仕様が無い」です。
更にヨコですが「くだらない」などの意味で使う「しょうもない」も、漢字にすると「仕様も無い」です。
ただし、私は、誤りなく伝えることができる書き方をする事こそが大事だと思います。できるだけ短く書こうとして、その為に別の意味にも読めてしまう書き方にならないように注意が必要ですね。
仕様書は、依頼主への提出する為だけの物ではなくて、後で運用・保守・改訂作業を行う際に無くてはならない物ですから。(ソフト屋さんでしたら判ると思いますが)特に、後から忘れた頃にやってくる改訂で、仕様書が揃っていないと非常に苦労することになります。
こんにちは。
仕様書の書き方って,習いました? - 日経エレクトロニクス - Tech-On!
http://b.hatena.ne.jp/entry/http://techon.nikkeibp.co.jp/article...
もうご存じかもしれないですが、上記が参考になるかと思い、紹介させていただきます。
また、簡潔に説明することも、あるていど量のある説明をすることにも使える点で、CPAN http://search.cpan.org/ のフォーマットが見易いのではないだろうかと考えました。専門家の方にご紹介するのは釈迦に説法で気が引けるのですけれども、よろしければご参照下さい。
以上、参考になれば幸いです。
こんにちは
* 基本仕様
* 機能仕様
* 詳細仕様
該当箇所の機能を上から順番に読めば仕様を理解できると言う書き方が、
わかりやすい仕様書だと思います。
状況にあった詳しさをで抑えられてるほうが、理解もしやすいですし・・。
=>書いて楽しい、見て楽しい
私もこれに関心があります。
いままで、書いて楽しいと思ったこともないし、
見て楽しいと思った仕様書もありません。
>見て楽しいと思った仕様書もありません。
やっぱりないですかぁ。
どこかにはあると思うんですよねぇ
こんにちは。
楽しいがポイントということですので、小説風に書くのはいかが?
小説ぽく、いきいきと記述。仕様書のユースケースや機能説明といったところではよいかも・・。
もとはJoel on Softwareからヒント。機能仕様書サンプルのシナリオのところです。
http://japanese.joelonsoftware.com/PainlessSpecs/WhatTimeIsIt_Jp...
あとは、ゆるーい手書き風フォントをいれて、テクニカルノートやメモ、ふきだし満載の仕様書にするとか。
#どっちもチャンスをうかがっているところで、まだ試したことはありませんが:-)
Joel on Software は私も好きです^^
>あとは、ゆるーい手書き風フォントをいれて、テクニカルノートやメモ、ふきだし満載の仕様書にするとか。
全部マンガでかくとか考えたことありました:-) 絵を多様すると読むための敷居が下がる気がするんですよね。
子供でもわかる仕様書みたいなの 作れないかなぁ
誤りなく伝えるために、読む気にさせるのも重要なのかなぁと思ってます。
運用・保守・改訂作業がまたしんどいです。なんとか楽しい作業にしたいですよね。