タグ

コメントに関するkoka_orzのブックマーク (2)

  • Visual Studio .NETによるチーム開発事始め Visual C# .NETでAPIリファレンスを作る(後編)(4/4) - @IT

    4.APIリファレンスの応用・関連知識 ■APIリファレンスの共有 APIリファレンスは開発者にとって欠かせない、便利なツールである。このツールをチームのメンバーがそれぞれ個別に所有するのではなく、チームで共有することができればもっと便利になるだろう。APIリファレンスを共有する方法としては、APIリファレンスをWebサイトにして、チーム内に公開するのがお勧めだ。Webサイトを立ち上げるには、WindowsのIISなどのHTTPサーバを利用するとよいだろう。IISの使用方法については、稿の旨から外れるのでここでは省略する。 ■XMLドキュメント・コメント 1. 「ドキュメント・コメントのタグ」の概要でも説明したように、VS.NETでC#を使う場合、APIリファレンスだけでなく、XMLドキュメント・コメントも出力することができる。独自のAPIリファレンスを構築したい場合には、XMLドキュ

  • CSS のコメントの書き方コレアレ

    CSSHTMLと同じように、ソース中にコメントを挿入することができます。 /*と*/で囲った文字列がコメントになりますが、入れ子にすることはできません。また、他のプログラムにあるような「#」や「//」といった単一行コメントはありません。 適切なコメントを挿入することで、複数人での作業するときや、時間がたってから編集するときなどにコードの見通しが良くなります。ブラウザ間の差異を埋めるための宣言やハックなんかも、適用させるブラウザ名や理由などをきちんとコメントで書いておきたいですね。 僕は、スタイルをグループに分けて記述するときなど、コメントを目立たせるために次のように記述しています。 /* ------------------------------ Header ------------------------------ */ div#header { } . . /* -------

  • 1