Inconsistent "missing_docs" warnings

[jpipard]

Hello all :-)
We get a lot of "missing_docs" warnings in our project. But we don't understand why. We installed SwiftLint via cocoapods pod 'SwiftLint', '~> 0.16.1'.

1. Here's the first example :
For this example, I don't understand why the comment for addConstraint is fine but not the one for removeContraint

2. And here's a second example for a struct :

Is there something missing in my comments formats ?
Thank you for your help!

[jpipard]

seems to be related to #728

[mgrebenets]

Same for us, this seems to be an old issue and it wasn't fixed when we moved onto Swift 3.
For now we had to disable missing_docs...

[jpsim]

That's right, this was tracked as #728 and the rules ultimately disabled for Swift 2.3+.