[B! Document] atsukanrockのブックマーク

atsukanrock id:atsukanrock

Documentに関するatsukanrockのブックマーク (11)

XML ドキュメントコメントでの、ジェネリックな型やメンバに付く - やこ〜ん SuperNova2
要約 XML コメントにて Generic な型やメンバを参照する場合、IEnumerable{int} のように書くことができる。ちょっとしたことだが、忘れがちな事である上、ぱっと検索しても出てこなかったのでメモってみた。詳細 C# の XML コメントにて、特に、や ... などで型やメンバの名前を書く場合に、それらが Generic であると面倒がある。というのも、例えばといった表記は XML の仕様もあって不可能なので、のように書かねばならないのである。上のように < や > を < や > に文字実体参照にエスケープすれば問題ないのだが、文字実体参照だと見づらくなりやすいという問題がある。例えば、XML コメントで <see cref="IEnumerable<KeyValuePair<Guid, Func<string, string
atsukanrock 2011/01/08
知らなんだ…

C#

Document
リンク
Plain Text Techniques | Techniques for WCAG 2.0
atsukanrock 2010/05/26
Document
リンク
マイクロソフトの日本語表記ルール | 日経 xTECH（クロステック）
昔から思うのですが、マイクロソフトの日本語表記ルールは実に奇妙です。現在は、広く一般に公開されていますので、ぜひ目を通してみてください。まず、マイクロソフトは世界中の多くの言語をサポートすることを強調しています。そのためのポータルサイトも設置されています。しかし、そのサイトの日本語名は「マイクロソフトランゲージポータル」。「ランゲージ」という言葉は決して一般的な用語ではありません。「ポータル」が一般に通じるかどうかも怪しいものです。各国の言語を尊重しているようにはとても思えません。ちなみに、フランス語サイトもスペイン語サイトも、最初のパラグラフに登場する英語は「Microsoft」だけです。なお、かなに相当する文字を持つ言語はどうだろうと思い、韓国語サイトを開いてみましたがハングルは読めませんでした。次に、各言語のスタイルガイドを見てみましょう。一覧の中で、私が知っている言語は日
atsukanrock 2010/02/12
Document

Microsoft
リンク
ツールを使ったドキュメント作成技法（後編）（1/3） - ＠IT
特集：ツールを使ったドキュメント作成技法（後編）マイクロソフトも実施しているドキュメント作成技法アバナード株式会社　市川龍太（Microsoft MVP 2008 for XML） 2008/07/23 前編では、価値のあるドキュメントを作成するためのコツと、効率的にドキュメントを作成するためのツールとして「SandCastle」を解説した。後編では、そのほかのドキュメンテーション支援ツールとして「GhostDoc」と「patterns & practices Documentation Tools」について解説する。 ■柔軟なXMLドキュメント・コメントを生成する「GhostDoc」 GhostDocは、あらかじめ設定した任意の書式にのっとったXMLドキュメント・コメントを生成してくれるVisual Studioアドインであり、MSDNマガジンにて「すべての開発者がダウンロードする
atsukanrock 2009/12/15
Document

Visual Studio
リンク
マイクロソフトランゲージポータル - ダウンロード
スタイルガイドのダウンロードスタイルガイドとは? スタイルガイドは、それぞれの言語で定義されている規則、およびスタイルの約束事を集めたものです。一般的なローカライズ上の規則、技術情報の記述の際に適用するスタイルや用語の用法、市場や文化的背景で規定される情報までを含めて "規則" と考えることができます。現在のところ、下記の各スタイルガイドをダウンロードしてご利用いただけます。現在ダウンロード可能なスタイルガイド: マイクロソフトアフリカーンス語スタイルガイドマイクロソフトアラビア語スタイルガイドマイクロソフトイタリア語スタイルガイドマイクロソフトインドネシア語スタイルガイドマイクロソフトウクライナ語スタイルガイドマイクロソフトウルドゥ語スタイルガイドマイクロソフトエストニア語スタイルガイドマイクロソフトオランダ語スタイルガイドマイクロ
atsukanrock 2009/10/13
Document

Microsoft
リンク
Google Code Archive - Long-term storage for Google Code Project Hosting.
Code Archive Skip to content Google About Google Privacy Terms
atsukanrock 2009/07/12
JavaScript

Document
リンク
TagReference - jsdoc-toolkit - A list of every tag. - Google Code
Code Archive Skip to content Google About Google Privacy Terms
atsukanrock 2009/05/27
JavaScript

Comment

Document
リンク
ドキュメントコメント用の推奨タグ (C#)
このブラウザーはサポートされなくなりました。 Microsoft Edge にアップグレードすると、最新の機能、セキュリティ更新プログラム、およびテクニカルサポートを利用できます。
atsukanrock 2009/05/27
C#

Comment

Document
リンク
Comparison of documentation generators - Wikipedia
The following tables compare general and technical information for a number of documentation generators. Please see the individual products' articles for further information. Unless otherwise specified in footnotes, comparisons are based on the stable versions without any add-ons, extensions or external programs. Note that many of the generators listed are no longer maintained. General information
atsukanrock 2009/05/12
ドキュメント生成ソフトの比較

Document

App
リンク
[.NET] SandCastle 用に、 namespace へのコメントをソースコードに埋め込む方法 - biac のそれさえもおそらくは幸せな日々@nifty
[.NET] SandCastle 用に、 namespace へのコメントをソースコードに埋め込む方法「いや、まだだから」より。その３．名前空間ごとに NamespaceDoc クラスを作成する。ということで、この方法があったりします。つまり、名前空間のコメントを入れるためのクラスを定義してしまうってゆー、まーなんというか、盲点というか、抜け道というかｗ C# だとこんな感じですねー。 namespace 対象とする名前空間 { /// <summary> /// 名前空間の概要 /// </summary> /// <remarks>名前空間の補足</remarks> [System.Runtime.CompilerServices.CompilerGeneratedAttribute()] class NamespaceDoc { } } …ぐふぅ。そんなぁ～!? f(^
atsukanrock 2009/04/28
.NET

Document
リンク
Namespace-level comments in Sandcastle?
atsukanrock 2009/04/28
Sandcastleでの名前空間ドキュメントの方法

.NET

Document
リンク
1