In Swift, I can write documentation at a protocol level now. There is a kick-ass feature added recently to Xcode 8 (beta 4). If I add documentation of function at the protocol level, it's available at the level of implementation.

Look, I wrote documentation to Task.run() and I can read it in MyTask implementation. So great!

I'm so excited about this little feature being added. Some time ago I faced this documenting problem, and I just hoped it would be added at some point, and apparently, it is!

Wouldn’t be handy if I only write documentation for protocol def. function and it show with every implementation?

— Marcin Krzyzanowski (@krzyzanowskim) May 5, 2016

Photo Credit: Courtesy of HTSABO