Navigation:  StyleCop 4.3 > StyleCop 4.3 Rules > Documentation Rules >

SA1632: DocumentationTextMustMeetMinimumCharacterLength

Previous pageReturn to chapter overviewNext page
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.

 


© Microsoft Corporation. All Rights Reserved.