Proposal: Permanently disable subjective "Quality of content" rules

[sharwell]

Several documentation rules are subjective and aim to establish the quality of documentation content. These rules take CPU time to evaluate and are an overall poor indicator of documentation quality. I believe with the rules in place, developers will be focused on the wrong aspects of documentation during the development process.

• SA1628: Documentation text must begin with a capital letter
• SA1630: Documentation text must contain whitespace
• SA1631: Documentation must meet character percentage
• SA1632: Documentation text must meet minimum character length
• SA1650: Element documentation must be spelled correctly

I propose that each of these rules be permanently disabled in StyleCopAnalyzers.

[pdelvo]

I would add

• SA1650: Element documentation must be spelled correctly

to that list.

I agree that a automatic tool should not be in charge to decide if documentation is usefull or not.

[sharwell]

@pdelvo I added SA1650 to the list. You are correct, other tools are more suitable for that.

[Noryoko]

👍