0

Return Value field associated with both ##RETURNS and ##VALUE?

Can someone explain why, for .NET assembly documentation, the Return Value field is associated by default with the ##RETURNS tag for methods and operators, but with the ##VALUE tag for properties and fields?

 The reason I ask is that our developers seem to always use ##RETURNS (<Returns></Returns>), regardless of whether they are commenting methods, operators, properties or fields. This seems reasonable to me. As a consequence, when I view a property in the editor, nothing is displayed in the Return Value field. However, the comment does display correctly in the generated documentation.

 (I would change the associated item type, but due to another issue that has already been bug reported, I can only use the default configuration.)

1 comment

Please sign in to leave a comment.