本ドキュメントははてなにおける技術文書の目次となっています。主にはてなスタッフがその作成と更新を行っています。
原文(投稿日：2009/08/10)へのリンク ソフトウェアアーキテクチャの文書化というのは、企業のアプリケーション開発プロセスにおいて重要である。プロジェクトにおけるアーキテクチャの文書化のニーズを理解する上で重要なことは、アーキテクチャの文書化がプロジェクトのライフサイクルにおいてどんな役割を果たすのか理解することだ。プロジェクトにおいて、アーキテクチャドキュメントを作成する根本的な理由は、コミュニケーションと分析と記録のためである（例えば、ある決定をドキュメントに記録しておくと、時間が経過しても失われることはない）。プロジェクトで作成するアーキテクチャドキュメントの量と種類は、そのプロジェクトで作成するプロダクトのコミュニケーションおよび分析のニーズを反映したものにするべきである。 アーキテクチャドキュメントは、プロジェクトからマネジメントへ、アーキテクトや主任設計者から開発者へ、プ
詳しすぎる詳細設計書 - SiroKuro Page の続きです。前の記事ではブクマありがとうございました。 はてな界隈の拒否反応を見る限り、詳しすぎる詳細設計書に良い印象を持ってる人は少なそうです。もっとも、私は良い面も持っていると思っていまして、 プログラマの技術的知識や業務的知識の量に左右されることなく、一定の品質を保つことができる なんてメリットがあります。属人性の排除ですね。 あたりまえですね。実は設計者が書いたプログラムを詳細設計書と呼んでいるんですから。しかもテストどころか処理系に食わせてすらいないプログラムです。悪く言えば机上の空論です。良く言えば……絵に描いた餅？ プログラマの技能に左右されないかわりに設計書の品質に左右されるので、一定の品質が「悪い方に一定」だったりすることもあって、色々と下流工程の鬱憤が溜まりそうです。既に溜まっていますね、ごめんなさい。 本題：古き悪
「詳細設計書」と呼ばれるドキュメントがあります。各処理の入出力や処理概要を記載した文章です。 入力： 「性別と身長のペア」のリスト 出力： 男性の平均身長」と「女性の平均身長」の差 処理概要： 変数「男性の合計身長」「女性の合計身長」「男性の人数」「女性の人数」を 0 で初期化する 入力を受け取る 入力されたリストから要素を読み込む 入力されたリストの要素数だけ以下を繰り返す 要素を１つ読み込み、条件分岐する もし要素が男性なら、変数「男性の合計身長」に身長を加算し、変数「男性の人数」を１増加させる もし要素が女性なら、変数「女性の合計身長」に身長を加算し、変数「女性の人数」を１増加させる 次の要素を読み込む 「男性の合計身長」÷「男性の人数」−「女性の合計身長」÷「女性の人数」を、変数「計算結果」に代入する 出力する イメージとしては、こんな感じ。各社それぞれ、どんな詳細設計書を書いてい
「提案書」や「要件定義書」は書くのが難しい。読む人がITの専門家ではないからだ。専門用語を使わず、高度な内容を的確に伝えるにはどうすればいいか。「提案書」「要件定義書」の書き方を通じて、「誰にでも伝わる」文章術を伝授する。 SEはさまざまな文書を作成する必要があります。その中でも、提案書や要件定義書の作成に悩むSEは多いようです。なぜなら、これらは「顧客に読んでもらわなければならない文書」だからです。 本連載では、「誰にでも分かる」提案書や要件定義書を作成するための文章術を解説します。ただし、分かりやすい文書を作成するには、文章術だけでは十分ではありません。必要な情報を顧客から引き出すためのコミュニケーション、文書全体の構成も重要です。 第1回では、SEが作成する文書はどのようなものかを概観します。第2回では、情報を引き出すための顧客とのコミュニケーションのポイントを説明します。第3、4回
How to Completely Test Your Website | Digital Inspiration 自分のサイトは他の環境ではどのように見えているのだろう？ IE では？ Firefox では？ OS の違いはどう影響している？ それと、モバイルで環境で見ている人が多い中、ロード時間はどうなっているのだろう？ こうした疑問に答えるために使えるサイトが Digital Inspiration でまとめて紹介されていました。最近テンプレートの変更作業で使う頻度が高まっていますので、自分がつかいそうなものだけピックアップしてご紹介いたします。 他の環境でのサイトの見え方をチェック まず Browsershots はご存じの人も多いと思いますが、Linux, Windows, Mac OS X など封数の OS に数多くのブラウザを組み合わせて何十種類ものスクリーンショットを作って
VB、VC++、C#、Java、Access、Excel対応版 ドキュメント自動生成ツール【A HotDocument】 ドキュメント自動生成ツール【A HotDocument】は、システム開発時におけるドキュメント作成を完全自動化しました。 VB、VC++、C#、Java、Access、Excelのファイルからクリック一つで、納品、保守用の美しいドキュメントを瞬時に、Excelファイル/テキストファイルへ自動生成します。 また、プログラム作成時に必要な、html/chm/xml形式の仕様書出力も可能になりました。 ニュースリリース (2024年1月4日) Visual Studio/Officeの次バージョン版の開発を開始しました。 1.【A HotDocument】とは 仕様書作成ツール【A HotDocument】の製品概要、仕様書の内容、使用方法、製品ラインナップをご紹介しておりま
MozillaのJavaScriptドキュメントとECMA Scriptの言語仕様を、まとめてHTMLヘルプ(chm)形式にコンパイルしました。Windows用です。 (2008-05-27 追記) OS XならChemrがいいみたいです。(参考) http://cid-57544de2edadf883.skydrive.live.com/self.aspx/jsref/jsref.chm *1 以下のドキュメントが入っています。 Core JavaScript 1.5 リファレンス http://developer.mozilla.org/ja/docs/Core_JavaScript_1.5_Reference Core JavaScript 1.5 ガイド http://developer.mozilla.org/ja/docs/Core_JavaScript_1.5_Guide G
【楽々デブドックを書こう！】開発☆ドキュン 第3回：基本設計の“いろは”ドキュ 著者：シンクイット編集部 公開日：2008/02/15（金） ちゃんとわかって書いてます？ 2月の特集「楽々デブドックを書こう！」の最終目的は「手戻りを発生させずにシステム開発をスムーズに進める」こと。決して「見栄えのよい開発ドキュメントを書こう」というものではない。本連載「開発☆ドキュン」ではその視点に立ち、よりよい開発ドキュメントの作り方について「妖精さん」と一緒におさらいしている。 さてこの「妖精さん」たちは、デスマーチ一歩手前の状況にある開発現場で死屍累々になっている開発者の皆様を「そっ」とサポートしてくれている頼もしい存在だ。特に「開発☆ドキュン」に登場する「開発ドキュメントの妖精さん」たちは、あなたが意識を失っている間に開発ドキュメントを書いてくれているのである。 …とはいえ、開発ドキュメントの妖精
【楽々デブドックを書こう！】開発☆ドキュン 第2回：要求分析するドキュよ 著者：シンクイット編集部 公開日：2008/02/08（金） 予想以上の反響で妖精さんはもっとがんばります！ システム開発をスムーズかつ手戻りを発生させずに進めるには「開発ドキュメント」の存在が欠かせない。2月の特集「楽々デブドックを書こう！」では、さまざまな視点から、この開発ドキュメントについて解説＆考察している。 デスマーチ一歩手前の状況にある開発現場では、「ふっ」と意識が遠のいたと思ったら見たことのないコードが書かれていたり、バグが忽然と消え去っていることがないだろうか。これはもちろん「妖精さん」たちの仕業なのである。 本連載「開発☆ドキュン」では、あなたが意識を失っている間に開発ドキュメントを書いてくれている「開発ドキュメントの妖精さん」であるA奈ちゃんとB乃ちゃんの2人の会話を追いかけながら、開発ドキュメン
【楽々デブドックを書こう！】開発☆ドキュン 第1回：開発ドキュメントって何ドキュか？ 著者：シンクイット編集部 公開日：2008/02/01（金） 妖精さんと学ぶ開発ドキュメント システム開発も終盤に差し掛かってくると、疲れが溜まったり、睡眠時間が足りないといったために「ふっ」と意識が遠のくことがある。しかし、自分で入力した覚えがないのにコードが書かれていたり、知らないうちにバグがどこかに消えていた、ということはないだろうか。 実は開発者の作業能力が低下すると、C言語で開発しているのなら「C言語の妖精さん」、Java言語で開発しているなら「Java言語の妖精さん」が、どこからともなく現れて、あなたの代わりに作業を続けてくれているのだ。 古くから使われている言語であれば、妖精さんたちも高いスキルを誇っているのだが、最近になって登場したり、重要視されるようになった箇所の妖精さんは、まだまだ新人
GT Nitro: Car Game Drag Raceは、典型的なカーゲームではありません。これはスピード、パワー、スキル全開のカーレースゲームです。ブレーキは忘れて、これはドラッグレース、ベイビー！古典的なクラシックから未来的なビーストまで、最もクールで速い車とカーレースできます。スティックシフトをマスターし、ニトロを賢く使って競争を打ち破る必要があります。このカーレースゲームはそのリアルな物理学と素晴らしいグラフィックスであなたの心を爆発させます。これまでプレイしたことのないようなものです。 GT Nitroは、リフレックスとタイミングを試すカーレースゲームです。正しい瞬間にギアをシフトし、ガスを思い切り踏む必要があります。また、大物たちと競いつつ、車のチューニングとアップグレードも行わなければなりません。世界中で最高のドライバーと車とカーレースに挑むことになり、ドラッグレースの王冠
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く