InfoQ ホームページ ドキュメンテーション に関するすべてのコンテンツ
-
アジャイルと根拠なき自信の支え
根拠なき自信は普通、希望的観測に基づいている。これは、予想した現実と実際の現実がかなり乖離しているかもしれないが、ある期間、すべてを制御できていると感じる状態だ。アジャイル開発にはこのようなチームが根拠なき自信を支えにして最終的には失敗してしまうことが多い。
-
-
アジャイルチームのアーキテクトのための10の助言
Microsoft AustraliaのソリューションアーキテクトであるTom Hollander氏は、TechEd Australiaでアジャイルチームにおけるアーキテクトの役割と題したプレゼンを行った。 氏はこの場でアジャイルチームを率いるアーキテクトとして氏が行っていることについて議論した。
-
どうやって著者にお金を払うか：マイクロペイメ��トサービスFlattr
今年始め、マイクロペイメントサービスFlattr(名前はflatrateとflatterの合成) がサービスを開始した。このサービスは方式はシンプルだが、ネットを通じて上質なコンテンツに対して報酬を与える方法を変える可能性を秘めている。このサービスを始めたのは、The Pirate Bayの創立者であるPeter Sunde氏だ。氏はこのサービスについて re:publicaのようなソーシャルメディアのカンファレンスで紹介している。
-
アジャイル ドキュメンテーション：その明確さは？
アジャイルのコミュニティにおいて，ドキュメントは明らかなテーマであっただろうか？ どれ位の量のドキュメントを作る必要があるのだろう？ 必要なものは？ 不要なものは？ 従来の開発プロセスのドキュメントをアジャイルに移行する方法は？ アジャイルコミュニティにおいてドキュメントは，明確な定義に欠けている分野なのだ。
-
討論 : NHibernate と EF 4 の比較
近頃、Oren Eini氏 (別名Ayende Raheim氏)の記事をきっかけにして、NHibernate と Entity Framework 4.0というふたつの .NET のオブジェクト/リレーショナルマッピングフレームワークについて、それぞれのメリットと能力に関する議論がわき起こった。InfoQはこの議論が与えてくれる視点を理解するため、この議論の詳細に分け入った。
-
Rubyのツール：Yard 0.4はライブ・ドキュメント・サーバを追加、Gem Bunlderは依存関係を取り扱う
ドキュメント生成ツールYardの0.4リリースはライブ・ドキュメント・サーバのような新しい機能を追加している。それにより、ユーザは文書にコメントすることができるようになる。��しいツールGem Bundlerは柔軟な依存関係管理を可能にする。
-
２タイプのアジャイル文書 ― ２種類しかない
アジャイルマニフェストには、「動くソフトウェアが、どんな文書よりも理解しやすい」、とある。このおかげで、アジャイルプロジェクトでは、文書は、要らないと多くのチームに信じられるようになった。アジャイルを批判する人たちは、その方法論の弱点を示すのに、アジャイルの少ない文書を指摘する。 Eelco Gravendeel氏は、アジャイルには、たった２種類の文書しかない、と言う。
-
文字エンコーディングとM17Nの解説
James Edward Gray II氏は、Rubyの文字エンコーディングに関する一連の投稿記事を書いた。それらは、Ruby 1.9への準備となる数々のコツと詳細な説明を提供する。
-
Fluent NHibernateがWikiを搭載
Fluent NHibernateは、NHibernateでのXMLマッピング使用に代わるものである。Fluent NHibernateは、緩やかなインターフェイスを使用し、XML.の代わりにコードでマッピングの定義を可能にする。コミュニティの人によっては、 Fluent NHibernate用の文書が不足していることに不満をこぼすものもいて、その反応として、近ごろJames Gregory氏はFluent NHibernate向けの正式なWikiを発表した。
-
YARD - Ruby向けのコードメタデータとドキュメント生成ツール
RubyFringe（Ruby過激派の意味）の講演で、Merbプロジェクトの参画者でもあるEngineYardの従業員のYehuda Katz氏が未来を見通すためにいくつかのツールを紹介した。それらはドキュメント生成ツールで、そのひとつであるYARDではRubyドキュメントにメタデータを付けることができる。
-
Article: 言語としてのアーキテクチャ： ストーリー
アーキテクチャは一般に、Word文書に主として見られるような極めて実体のない、ソフトウェアシステムの概念的な側面であるか、または完全に技術によって駆動されるものかのいずれかです。そのどちらも間違っています。では、どう対処すればよいでしょうか? この記事ではアイデアを説明します、そしてアプローチのキーポイントを要約します。
-
Sandcastleのソースのリリース
先月、クローズドソースツールであるSandcastleを、オープンソースサイトであるCodePlexでホストすることに対して騒動があった。顧客の要望に応えて、MicrosoftはSandcastle向けのソースコードをリリースした。
-
-
ソフトウェアアーキテクチャの新しいリソース
ソフトウェアアーキテクトのための新しいリソースがいくつか表れた。Simon Brown氏とKevin Seal氏はソフトウェアアーキテクチャ文書を作るためのガイドライン集を公表した。Mike Kavis氏も新しいアーキテクチャがもたらす変化への対応にせまられるアーキテクトにとって役立つフレームワークを考え出した。