「C/C++言語」のプログラムを作る際には、以下のルールが参考になる。

C言語は、かなり自由のある記述ができる反面、記述の仕方によっては判りにくかったり思わぬバグも入りこんだりする。昨今は以下に記載のようなコーディングルールが規格化されている。ここに書かれているような事を心がけることで、信頼性・保守性・移植性・効率性 などで品質が安定する事が期待できる。

ソース上に記述するコメントをDoxygenの規則に従った記述とする事で、見栄えのよいドキュメントが生成できる。以下の記事に従ったコメント記述がお勧め。

「Doxygen記述ルール」