This project is read-only.

SA1642 - c#-specific phrasing in value type constructor summary

Feb 10, 2015 at 12:26 PM
Rule SA1642 enforces the following initial sentence in a value type constructor summary:
Initializes a new instance of the <see cref="MyType"/> struct.

Now "struct" is a C#-specific keyword, influenced by C, for declaring value types. Forcing it in XML documentation leaks the language of implementation and might confuse users of other CLR languages. I know changing the text template now is a backwards compatibility issue, but still it bothers me.