Заголовок с протоколами делегатов - Swift и xcode 7.2

Question

Я определил протокол и добавил документацию HeaderDoc к методу в этом протоколе. Он отображается правильно, когда я Option+ Нажмите на метод:

Тем не менее, когда я Option+ щелкните реализацию внутри контроллера, который реализует этот протокол, документация не отображается:

Я ожидаю, что документация, которую я написал для протокола, будет отображаться в контроллере, аналогично документации Apple:

Как сделать так, чтобы документация по протоколу была видна в другом месте?

Answer 1

Если вы документируете реализацию метода протокола в расширении протокола, документация будет видна в любом типе, который соответствует протоколу.

Если вы опустите документацию расширения, canDo Как вы заметили, документация по протоколу не отображается нигде, кроме самого протокола.

protocol Doable {
    /// Does something
    func canDo()
}

extension Doable {
    /// Does something really well
    func canDo() {
        print("Did it!")
    }
}

struct Task: Doable {
    init() {
        canDo()
    }
}