blockdiag シリーズで色々な作図をしてみる
作図をするときに使うソフトというと PowerPoint とか Visio とか色々あるけど、大抵は GUI で素材をチマチマとドラッグアンドドロップしていく系が多いと思う。 ただ、保存形式がバイナリだとバージョン管理なんかと相性悪いし、なにかをひとつ追加するだけで周りを全部移動させたりーとか考えると結構めんどいこともある。 それに対して blockdiag シリーズはテキストベースの設定ファイルを図に変換することができるツールだ。 blockdiag シリーズは作成する図に応じて blockdiag、seqdiag、nwdiag、actdiag と分かれていて、それぞれブロック図、シーケンス図、ネットワーク図、アクティビティ図を作成することができる。 まずはブロック図を作成できる blockdiag から使ってみよう。 OS X だと、まずは Homebrew で依存パッケージを入れてお
あなたの仕様書は大丈夫？ 日本語文のあいまい度診断ツール『ClearDoc』でドキュメントをチェック
ウォーターフォール型の開発では、要件定義、設計、プログラミング、テスト、運用といった作業工程が時系列に進んでいく。開発当初に作成される要件定義や基本設計のドキュメントは、そのプロジェクトに関わる人たち全員が目にするため、そのドキュメントにあいまいな点や複雑な点などがあれば、後々の行程で問題が発生し、品質と生産性に影響する。この課題を解消するのが、株式会社シーイーシー PROVEQサービス事業部の開発した日本語文のあいまい度診断ツール『ClearDoc』だ。 ウォーターフォール型の開発では、要件定義、設計、プログラミング、テスト、運用といった作業工程が時系列に進んでいく。開発当初に作成される要件定義や基本設計のドキュメントは、そのプロジェクトに関わる人たち全員が目にするため、そのドキュメントにあいまいな点や複雑な点などがあれば、後々の工程で問題が発生し、品質と生産性に影響する。この課題を解消
仕様書の書き方はどうやっておぼえるのか - Some Days You Get the Bear
（仕様書というよりは）資料を書くときにごく普通に意識していること。 ■言葉を統一する 同じものを指すのなら、常に同じ言葉で書き表す。 ■初出のものには説明を 重要なもの・ことについては、章を割いて説明する。 読み手の前提知識がどの程度で、どこまで説明を必要としているかを考える。 ■説明の流れを意識する 「どう説明したらわかったもらえるだろうか？」を意識し、 絵や語句の登場順などの、各章の関連・構成を考える。 ■図解 必要に応じて、文章や言葉を説明するための絵を示す （文章を使って絵を説明する、とも言える）。 このとき、説明したい文章・言葉と絵が対応づけされていることが 読み手にわかるようにする。 おおざっぱにイメージで言えば 読み手を迷わせない、混乱させない、ムダに想像させない ということだ。 こういう視点で見れるようになったのは たぶんレビューでいろんな人の資料を見るようになったからなの
まずは「箇条書き」でしょ！ ～仕様書の書き方（２）～ - Some Days You Get the Bear
仕様書の書き方、第２弾です。 漏れ抜けのないようにと、あれもこれもと盛り込みたくて、 ついつい長文になってしまうこと、けっこう多いように感じています。 しかし、仕様書は、 まずは「箇条書き」です！ 要素をきちんと分解し、１つのことを１つの項目として書き表すこと、 これがすごく大事な観点だと思っています。 なぜならば！ 我々は仕様書を書いているのだから。 なんだそりゃ！？ とお思いでしょうが、仕様書ならではの以下の役割があるからです。 ■よい設計の観点から 機能ブロックや入力情報等がきちんと整理・分解されることは、そのままわかりやすい設計につながります どんな機能、どんな情報があるかをきちんと把握できることは、システムの登場人物を正しく把握でき、概要の理解を助けます ■トレーサビリティの観点から 次工程のインプットとして、仕様書どうし・仕様どうしの各項目の対応付けが明確になります 特に仕様が
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
