Documentation Rules


From StyleCop 4.5 this rule is disabled by default.

A section of the Xml header documentation for a C# element is too short.

Rule Description

C# syntax provides a mechanism for inserting documentation for classes and elements directly into the code, through the use of Xml documentation headers. For an introduction to these headers and a description of the header syntax, see the following article: http://msdn.microsoft.com/en-us/magazine/cc302121.aspx.

A violation of this rule occurs when part of the documentation is too short. This can often indicate that the documentation is not descriptive. For example:

    /// <summary>

    /// A name

    /// </summary>

    public class Name   




How to Fix Violations

To fix a violation of this rule, rewrite the documentation text using grammatically proper and descriptive language. In most cases, doing so will cause the length of the documentation text to be greater than the minimum length which causes this rule to fire.