SA1644: DocumentationHeadersMustNotContainBlankLines

[sharwell]

http://www.stylecop.com/docs/SA1644.html
https://github.com/DotNetAnalyzers/StyleCopAnalyzers/blob/master/documentation/SA1644.md

[sharwell]

I think this rule had good intentions, but it's the wrong actual rule to use. I think we should implement this by making sure paragraphs are wrapped in block-level elements. Two spans of text are considered part of different paragraphs if there is a blank documentation line between them. An example of two paragraphs separated by a blank line can be seen in SA1616ElementReturnValueDocumentationMustHaveText.cs.

[sharwell]

It doesn't look like this rule will have a champion for the RC 1 release. Since it's a relatively minor rule and even has some disagreement (from me 😉 ), I'm moving it to the Backlog milestone to deal with after the 1.0 release.