<!DOCTYPE qhelp PUBLIC

"-//Semmle//qhelp//EN"

"qhelp.dtd">

<qhelp>

<overview>

<p>

A public method that does not have a <code>&lt;typeparam&gt;</code> tag for each parameter

makes an API more difficult to understand and maintain.</p>

</overview>

<recommendation>

<p>The documentation comment for a class or method should include <code>&lt;typeparam&gt;</code> tags

that describe each type parameter.</p>

</recommendation>

<example>

<p>The following example shows some examples of correct and incorrect ways to document type parameters.

parameter.</p>

<sample src="XmldocTypeParam.cs" />

</example>

<references>

<li>

MSDN, C# Programming Guide:

<a href="http://msdn.microsoft.com/en-us/library/b2s063f7.aspx">XML Documentation Comments</a>,

<a href="http://msdn.microsoft.com/en-us/library/z04awywx.aspx">How to: Use the XML Documentation Features</a>,

<a href="http://msdn.microsoft.com/en-us/library/5ast78ax.aspx">Recommended Tags for Documentation Comments</a>.

</li>

</references>

</qhelp>