Documentation comments for public methods and constructors should use the <param> tag to describe the available parameters. If the comment includes any empty, incorrect or outdated parameter names then this will make the documentation more difficult to read.

The documentation comment for a method or constructor should always use non-empty <param> values that match actual parameter names.

The following example shows a documentation comment that references an out of date name amount in its <param> tag, which should be renamed to incrementBy.

  • MSDN, C# Programming Guide: XML Documentation Comments, How to: Use the XML Documentation Features, Recommended Tags for Documentation Comments.