documentに関するmaruguuのブックマーク (3)

  • IBM対スルガ銀行事件判決評釈(東京地判平成24年3月29日第一法規判例体系) - アホヲタ元法学部生の日常

    巨象も踊る 作者: ルイス・V・ガースナー,山岡洋一,高遠裕子出版社/メーカー: 日経済新聞社発売日: 2002/12/02メディア: 単行購入: 22人 クリック: 313回この商品を含むブログ (94件) を見る 1.はじめに ITクラスタに多大な衝撃を与えた、IBM対スルガ銀行事件判決。判決直後の「4月1日」に、その時点で明らかになっていた情報から憶測して、以下のネタ記事を書いたことは記憶に新しい。 判例評釈速報:IBM/スルガ銀行システム開発事件〜東京地判平成24年3月29日判例集未登載(控訴) - アニメキャラが行列を作る法律相談所withアホヲタ元法学部生の日常 判決直後には、IBM側の申立てにより開示されなかった*1判決文が、平成24年5月16日、第一法規判例体系に掲載された。同業他社のデータベースを確認したところ、現時点の掲載はないとのことであるので、第一法規の「スク

    IBM対スルガ銀行事件判決評釈(東京地判平成24年3月29日第一法規判例体系) - アホヲタ元法学部生の日常
  • ダメなマニュアルの特徴 - まめめも

    めちゃくちゃ遅い反応ですが、「よく言ってくれた!」という話。 現状のRDocはユーザリファレンスに向いてないと思ってる。 RDoc書いただけで「リファレンスは完璧だお!」とか言ってるやつなんなの - Greenbear Diary (2009-06-04) 以下関係あるようなないような話。わが身は振り返らない方向で。 ダメなマニュアルの特徴 rdoc に限った話ではないですが、以下はダメなマニュアルに共通する特徴だと思います。 クラスやメソッドを ABC 順に並べている メソッドの説明が長い サンプルコードがない こういう文書は読み手を普通のプログラマだと思ってません。 なぜダメか ABC 順だと、どこから読めばいいかわからない。砂漠の真ん中で迷子になったような気分になります。早く使ってみたいのに使えない歯がゆさ。 説明が長いのは、メソッドの名前が適切でない可能性や、無駄に全機能を列挙しよ

    ダメなマニュアルの特徴 - まめめも
  • 要求仕様(要求工学:第3回)

    概 要 今回はIEEE830[1]に基づいてソフトウェアに関する要求仕様の標準的な構成例を紹介しよう。立命館大学の大西教授と山梨大学の郷助教授による「要求工学」[2]の第4章でもIEEE830が解説されている。 IEEE830では表1に示すように要求仕様を、目次、はじめに、要求仕様の一般的な説明、要求仕様の具体的な説明、付録、索引から、構成することを推奨している。 IEEE830 では、ソフトウェアをシステムの一部であるとしており、システムの要求仕様とソフトウェアの要求仕様を区別するためソフトウェア要求仕様( Software Requirements Specification)を略してSRSと記述する。これに対してシステム要求仕様をSyRSと略記する[3]。稿ではSRSについて解説する。 表1 IEEE 830 による要求仕様の構成 SRS 第1章「はじめに」 「はじめに」ではSRS

    maruguu
    maruguu 2009/02/24
    IEEE 830-1998 SRSの推奨される書き方の説明
  • 1