StyleCop 4.3 > StyleCop 4.3 Rules > Documentation Rules > SA1632: DocumentationTextMustMeetMinimumCharacterLength

StyleCop 4.3	Send comments on this topic.
SA1632: DocumentationTextMustMeetMinimumCharacterLength

Glossary Item Box

TypeName	DocumentationTextMustMeetMinimumCharacterLength
CheckId	SA1632
Category	Documentation Rules

Cause

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.