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