mxb さんの CSS コーディング規約見てました。
んで、常々思ってたんですがヘッダコメントとか必要ですかね?
クラスにしろ css にしろ JavaScript にしろ
あ、ソース管理システム使ってないとか、コメントで変更履歴(笑)な環境は除外してます。
クラスなんかの場合、ドキュメントコメントに書けばいいのにわざわざヘッダコメントに書いてあるとか意味わかりません。
修正の度に最終更新日変更しなきゃならないとか面倒です。
そもそも作成者と作成日になんの意味があるんでしょう?どうせもういないのに
変更履歴のコメントに助けられたことはあっても、ヘッダコメントに助けられたことは一切ありません。
今のプロジェクトは変更履歴の概要をヘッダコメントに書くことになっています。
クラスファイルを開くと、ヘッダコメントと using で一画面埋まってるとかうんざりします。
確かに全般的な説明がほしい場合はあります。
css とか JavaScript とかはドキュメントコメントのような機能はありませんしね。
それでも、簡潔に1~3行程度で十分ですので
以上、VSからファイルを開いたら一面緑文字オンリーで「なんかもうやってらんね」な気分になった人の戯言でした