僕の考えは、以下のような感じ。 (1) ドキュメント(設計書だろうが仕様書だろうが)は、「誰に何をどう伝えるべきか」を考えれば、何を揃えればいいかは自然と決まってくる。そして、誰が読んでも意味がないと判断されるドキュメントは意味がないので書かない... 続きを読む
HowToWriteAnEffectiveDesignDocument - 設計文書のうまい書き方 目次 この文書について 設計文書のうまい書き方 なぜ設計文書を書くのか 良い設計とは何か 同僚の開発者に向けて書く 第 1 節に書くこと: プロジェクト/サブシステムの目的を示す 第 2 節に書く... 続きを読む
昔、無駄なドキュメントは書くな(http://d.hatena.ne.jp/hyoshiok/20050510#p1)というよた話を書いたのだが、酒の席で、似たようなお話をしたので、いろいろ考えてみた。酒の席でのお話というのは、次の日すっきり、さっぱり忘れるのが常であるので、詳細はもち... 続きを読む
WebOS Goodies へようこそ! WebOS はインターネットの未来形。あらゆる Web サイトが繋がり、共有し、協力して創り上げる、ひとつの巨大な情報システムです。そこでは、あらゆる情報がネットワーク上に蓄積され、我々はいつでも、どこからでも、多彩なデバイス... 続きを読む
文章作成や校正に役立つ ネットで類語を検索する方法 ビジネス文章を作成したり校正する中で、同じ言い回しが続いてしまい、類語表現について調べたいと思うことはしばしばあるのではないでしょうか。そんなときにあると便利なのは類語辞典ですが、もしそれが... 続きを読む
また、開発工程に入る前の受注段階では、提案書の作成が求められます。開発工程が終了した後(もしくは並行して)、マニュアルや説明書の作成やその支援をすることがあります。 ■それぞれの文書の目的、内容 SEが作成する文書には、それぞれ目的があります。文... 続きを読む