コードインスペクション：無効な XML ドキュメントコメント

通常のコメントとは対照的に、3 つのスラッシュ /// で始まる XML ドキュメントのコメントは特定の構造を持ち、 サポートされている XML タグを使用する必要があります。

XML ドキュメントが正しく記述されている場合は、ツールを使用してコードベースのドキュメントを自動的に生成し、IDE で シンボルドキュメントを包括的に表示できます。

このインスペクションは、次のような XML ドキュメントコメント内のさまざまな問題を特定できます。

• 閉じられていないタグ。

• <see cref=""/> タグ内の不明またはあいまいな参照。

• 一部の行では、3 重スラッシュではなく 2 重スラッシュが使用されています

これらの問題はすべてコードの機能には影響しませんが、コードの保守性と API の使いやすさを向上させるために対処する価値はあります。