コメントにおいて、remarksタグは、他からメソッドを参照するときには表示されない。
他から呼び出す時は知らなくていいのに、内部処理の補足に使おう、と考えていました。
しかし、同僚に教えてもらったのですが、remarksタグも他から呼び出すときに表示されるのです。
やってみれば一目瞭然。
内部処理の補足は一行コメントで書けばいいらしいです。
コメントにおいて、remarksタグは、他からメソッドを参照するときには表示されない。
他から呼び出す時は知らなくていいのに、内部処理の補足に使おう、と考えていました。
しかし、同僚に教えてもらったのですが、remarksタグも他から呼び出すときに表示されるのです。
やってみれば一目瞭然。
内部処理の補足は一行コメントで書けばいいらしいです。