Headerdoc с делегатом Протоколы - Swift и xcode 7.2

Question

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

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

Мое предположение заключается в том, что документация, которую я написал для протокола, будет отображаться в контроллере, аналогично документации от 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() 
    } 
}