個人にもチームプロジェクトにも役立つソースコードのコメントの使い方長期に渡るプロジェクトほどコードのコメントは重要性を増すものです。複数のプロジェクトを同時進行したり、複数の人が関わるチームで開発するときなどに役立つコメントの使い方を紹介します。 Source Code Comment Styling: Tips and Best Practices [ad#ad-2] 下記は気になった箇所をピックアップして意訳したものです。 コメントのスタイル より良いコメントにする4つのテクニック コメントのスタイル 1. インラインのコメント ほとんど全てのプログラム言語でインラインのコメントが使えます。これは一つのポイントに一行のコメントのテキストを書くことに限定されます。 例を見てみましょう。 // begin variable listing var myvar = 1; .. これはその機能を説明するためのコメントで、使い方としては申し分ないでしょう。もし
