タグ

2010年1月7日のブックマーク (6件)

  • 詳細設計書に何を書くべきか? - Sacrificed & Exploited

    詳細設計書の書き方については黙っていられないので、ちょっと意見を言わせてもらう。 私も「詳しすぎる詳細設計書 - SiroKuro Page」で示されているようなコードと1対1に対応したような詳細設計書は、書くだけ無駄だと思っている。ただ、ちゃんとした詳細設計書をつくるなら、処理内容(内部の処理の実装方法)の書き方をどのように実装言語に合せるかではなく、処理内容を一切書かないようにするべきだと考えている。 なぜなら、処理内容をいくら詳細に記述したところで、それは仕様ではなくコードであり、仕様の代わりに記述したコードでは、バグも含めて記述されているため、そのコードのみでは正しいか間違っているかを判定できないからだ。 コードの他にどういった動作が正しいのかを判定する基準が必要で、その基準が仕様であり、詳細設計書にはその仕様を記述する必要があると考えている。 現に、例として示された処理概要では、

    詳細設計書に何を書くべきか? - Sacrificed & Exploited
  • 設計書の非常識1.設計書には詳細な実装方法を書く - Sacrificed & Exploited

    SIerの常識:「誰が書いても同じソースコードになるように、詳細な実装方法の記述された設計書を書かなければならない」 プログラマの常識:「誰が書いても同じソースコードになるような設計書は書くだけ無駄、誰が書いても同じ振る舞いをするように、詳細に振る舞いを記述した設計書を書かなければならない。」 プログラムを作るうえで設計書や、仕様書の類は欠かすことができない だが、設計書や仕様書をちゃんと作っているプロジェクトでもよくデスマーチに陥っている。 なぜか?「設計書に記載するべき内容が間違っている」からだ。 (設計が間違っている場合も多々あるが。) 間違ったことをまじめにやっても良い結果は得られない。 「誰が書いても同じコード」は大事なことなのか - yvsu pron. yas 昨日、大手SIerの方々と話をする機会があって、そこで出てきたのが、「誰が書いても同じコード」になることが重要で、そ

    設計書の非常識1.設計書には詳細な実装方法を書く - Sacrificed & Exploited
  • 詳しすぎる詳細設計書 - SiroKuro Page

    「詳細設計書」と呼ばれるドキュメントがあります。各処理の入出力や処理概要を記載した文章です。 入力: 「性別と身長のペア」のリスト 出力: 男性の平均身長」と「女性の平均身長」の差 処理概要: 変数「男性の合計身長」「女性の合計身長」「男性の人数」「女性の人数」を 0 で初期化する 入力を受け取る 入力されたリストから要素を読み込む 入力されたリストの要素数だけ以下を繰り返す 要素を1つ読み込み、条件分岐する もし要素が男性なら、変数「男性の合計身長」に身長を加算し、変数「男性の人数」を1増加させる もし要素が女性なら、変数「女性の合計身長」に身長を加算し、変数「女性の人数」を1増加させる 次の要素を読み込む 「男性の合計身長」÷「男性の人数」−「女性の合計身長」÷「女性の人数」を、変数「計算結果」に代入する 出力する イメージとしては、こんな感じ。各社それぞれ、どんな詳細設計書を書いてい

    詳しすぎる詳細設計書 - SiroKuro Page
  • Tracの任意のWikiページをPDF出力するスクリプトを作ったよ(暫定版)

    TracのPDF出力する方法は、以前の記事でも述べたようにいくつかあります。 が、その中で唯一日語に対応しているTracWikiExportプラグインは、 残念な事にテーブル内に日語構成が含まれていた場合にテーブル構造が崩れたり、 {{{#!html}}} を正しく解釈できないという微妙な問題を含んでいます。 それで困っていたので、簡単にJavaPDF出力ライブラリのiText5を利用して作ってみました。 サラッと作っただけでまだバグバグですが、コアとなるJavaの部分だけ晒しておきます。 launchpad.netにあげているので、ここからダウンロードできます。 目標としてはAdobeAirを利用したプレビュー機能&ダウンロード機能をつけたいですね。 ちなみに、プラグインとして作らずにAPIを利用して別アプリとして作ったのは、 PDF出力する状況を考えるとTrac上にプラグインとし

    Tracの任意のWikiページをPDF出力するスクリプトを作ったよ(暫定版)
  • Windows Mobile向け、タッチ操作に対応したオープンソースプロジェクト「Touch Controls - Fluid -」 - 酢ろぐ!

    Apple社のiPhoneにシェアを逆転されたニュースが記憶に新しいです。流行りなのかWindows MobileもiPhoneを追従して、指タッチに対応しようとしている様に思います。 Windows Mobile 6.5になってようやくGesture APIに対応した位で、ネイティブ・.NET Compact Framework共に開発者にとって指タッチに対応したアプリの開発は容易ではありません。iPhoneAndroidでは簡単に使えるコントロールが、.NET CFでは数百行書かないと実装出来ない事も多々あります。 Windows Mobile 6.x向けのiPhoneライクなコントロール・ライブラリが、オープンソースで公開されていました。 Fluid - Windows Mobile .NET Touch Controls - Home からFluidのソースコードをダウンロードし

    Windows Mobile向け、タッチ操作に対応したオープンソースプロジェクト「Touch Controls - Fluid -」 - 酢ろぐ!
  • 「GodMode」以外にもあった「Windows 7」の隠し機能--マイクロソフト幹部が自ら公開

    Windows 7」の管理機能を集約する「GodMode」機能に興味を持った人にとっては、同OS内には他にも類似のショートカットが数多く隠されているという事実も、気になる話題かもしれない。 Microsoftで「Windows」部門のプレジデントを務めるSteven Sinofsky氏によれば、これらの機能は開発者向けにさまざまな内部設定へのショートカットを提供するもので、同様の機能は「Windows Vista」、さらにはそれ以前から存在していたという。同氏はCNETに対し、複数のブロガーによって発見されたいわゆるGodMode設定フォルダは、Windows内に数多く盛り込まれている開発者向け機能の1つにすぎないと述べた。 Sinofsky氏は電子メールによるインタビューの中で、複数ある類似の隠し機能により、ロケーションの選択から電源設定の管理や生体認証センサーの識別まで、あらゆる種類

    「GodMode」以外にもあった「Windows 7」の隠し機能--マイクロソフト幹部が自ら公開