タグ

documentに関するneumannのブックマーク (9)

  • 電八開発倶楽部 - Doxygenコメント

    コメントの義務 他のコメント同様doxygenコメントも義務ではありません。コメントを付けようと思うとき、doxygenコメントにすることも義務ではありません。普通のコメントが付いていれば誰かがdoxygen形式に直します。たぶん。 ただし、コメントを付けるときにDoxygenコメントに配慮することは義務です。doxygenコメントは以下のコメント書式で始まりますので、ドキュメントに出力される必要の無いコメントはこのコメント書式を避けてください。 /** /*! //! /// Doxygenコメントの書き方 以下では、doxygenコメントの電八ソースにおけるルールを示します。つまり、doxygen自体の使い方は主眼ではないです。より良いルールに改訂するためにご意見をお待ちしています。 doxygenは割とメジャーなツールなので、使い方自体はウェブ上に大量の参考になるページがあります。使

  • 英語論文に使う表現文例集のレジュメ

    英語論文に使う表現文例集」のレジュメ ・このレジュメは、迫村純男 & Raeside,J.「英語論文に使う表 現文例集」(1996年、ナツメ社)の内容をまとめて、参照しや すいようにHTML形式で表したものです。説明等は省いてあるの で、詳しくは同書を参照して下さい。 ・必要な文例をコピーする場合は、範囲指定して反転した部分に カーソルをのせたまま右ボタンをクリックするといいでしょう。 ・転載等は御遠慮下さい。 Abstracted by M.KAMEGAYA 1997 1.前文 (a)論文の目的 The purpose of this study is ... This study provides ... This paper attempts to ... I would like to examine ... 【研究する】investigate, show, consider,

  • 403 Forbidden

    \閉鎖予定のサイトも売れるかも?/ アクセスがないサイトもコンテンツ価値で売れる場合も… ドメインの有効期限を更新してサイト売却にトライしてみましょう

    neumann
    neumann 2008/04/14
    OUTPUT_LANGUAGE = Japanese USE_WINDOWS_ENCODING = YES INPUT_FILTER = "nkf -w" FILTER_PATTERNS = FILTER_SOURCE_FILES = NO
  • [ThinkIT] 第5回:品質管理 (3/4)

    説明の中で、(I1)や(S2)などの記号が出てきますが、これは第1回で使ったプロジェクト管理状況チェック表のNo.と対応しています。チェック表で明らかになった問題点に対応する部分は、特に注意して読んでみてください。 PMBOKの品質計画プロセスでは、費用対効果分析や品質コストの算出などを行い、「品質マネジメント計画書」「品質測定基準」「チェックリスト」を主なアウトプットとしています。品質マネジメント計画書には、品質を保証・改善してゆくための組織構造や責任分担、手順、経営資源などを定義するのですが、少し概念的なのでこのままでは利用できません。実用レベルに落とすにあたり、弊社のプロジェクト管理手法PYRAMIDでは「品質基準書」を品質計画プロセスのアウトプットとしていますが、今回そのテンプレートを用意しました(図1)。このテンプレートでは、"システム全体"とか"操作性"などのテーマ単位にレスポ

  • svnseeds’ ghoti! - 日本語で上手な文章を書くには:10の「べからず」

    やや唐突ですが僕の友人のユダヤ系アメリカ人から面白いメモをもらったので、人了解のもと転載します(名前は一応仮名にしておきます)。原文は英語ですが適当に訳してみました。事実誤認など突っ込みどころ満載なんですがあまりに面白いのでそのままにしてあります。 僕から見ると皮肉が利きすぎているように思うのですけど、人はいたって大真面目のようです(笑)。どっかに載せるつもりなんだろうか。止めといた方がいいと思うけどなあ。わはは。 日語で上手な文章を書くには アイザック・シュワルツ(仮名) 私たちには日の公立学校に通う小学6年生の娘がいる。彼女は小学生になる前から日で暮らしているため日語には不自由していないのだが、毎年の夏休みの課題でどうしても良い評価をもらえないものがある。読書感想文だ。 日の小学校には課題図書というものがあり、全国の小学生たちはみな同じを読んでそれについて感想文を書くこ

    svnseeds’ ghoti! - 日本語で上手な文章を書くには:10の「べからず」
    neumann
    neumann 2006/09/09
    何度読んでも何も言っていないように読める文章はもっと良い
  • Visual Studio .NETによるチーム開発事始め Visual C# .NETでAPIリファレンスを作る(後編)(2/4) - @IT

    2.クラス・メンバの詳細情報を記述する APIリファレンスで、クラス・メンバ(フィールド、メソッド、プロパティ、インデクサなど)の詳細情報を表示するためには、クラスの場合と同様に「ドキュメント コメントのタグ」を使って、メンバごとにコメントを記述する必要がある。 ■フィールドで使えるタグ フィールドでは、<summary>タグ、<remarks>タグ、<newpara>タグを使用できる。 <summary>のコメントではフィールドの意味や内容を書く。<remarks>のコメントではフィールドを使用するときの注意点を記述したり、フィールドをフラグとして利用している場合はそのフラグの値の意味を記述したりするとよいだろう。ドキュメント・コメントのタグ入力とその出力例は次のようになる。 /// <summary> /// 最新の計算結果を演算子タイプごとに保持している。 /// </summary

  • 正しい技術文章作成のためのヒント

    This domain may be for sale!

    正しい技術文章作成のためのヒント
  • http://www.hirax.net/pukiwiki/pukiwiki.php?%C8%BD%A4%EA%A4%CB%A4%AF%A4%A4%CA%B8%BE%CF%A4%F2%BD%F1%A4%AF%CA%FD%CB%A1

    neumann
    neumann 2005/06/12
    論理が飛躍するとよく言われる…。まずは、文はできる限り短く、から始める。
  • [ThinkIT] 第1回:開発ドキュメント体系と業務フロー (1/4)

    ソフトウェア業界の仕事は、下請け・孫請けのピラミッド構成となることが多く、常駐・派遣型のビジネスがかなりのパーセンテージを占めています。そんな中、他の業界と同じように、下請け脱却を目指して"一括請負"で仕事を引き受けたいとする会社もあります。 その志は善しとしましょう。しかし、肝心の"実力"が伴っていないと発注者も受託者もお互いに手痛い目に遭います。ここで言う"実力"とは、単なる技術力のことではありません。スケジュール管理や品質管理、コスト管理などのプロジェクト管理の技術・体制を社内で持っているかどうかが成否の鍵となるのです。 筆者の会社は創立11年目なのですが、創業以来「常駐・派遣の仕事はやらない!」という起業時のポリシーを貫いて来ました。C/SやWebのシステム開発を主体としているのですが、10年間の中では当然(?)、いくつかの失敗プロジェクトもありました。その苦い経験の中で「成功率と

  • 1