Open ds1709 opened 2 weeks ago
This is by design, although not without problems. See https://github.com/DotNetAnalyzers/StyleCopAnalyzers/blob/master/documentation/Configuration.md#documentation-requirements, specifically the description for documentInterfaces
:
Specifies whether interface members need to be documented. When true, all interface members require documentation, regardless of accessibility.
Note that although it says "interface members", this also applies to interfaces themselves.
If you do not require documentation specifically for interfaces, then you can set documentInterfaces
to false
. That would mean that the remaining documentation settings would apply equally for interfaces and other types.
Duplicate of #2934. This also links to a request to make SA1600 etc more configurable.
Setting documentInterfaces to false solves the problem partialy. It not requires to document internal interfaces now, but it also not requires to document members of public interfaces, but requires to document interface itself.
As described,
SA1600
fires warning for internal interfaces even ifdocumentInternalElements
option set tofalse
. Works correct for classes. Mystylecop.json