带有委托协议的 Headerdoc - Swift 和 xcode 7.2

Question

我已经定义了一个协议，并将 HeaderDoc 文档添加到该协议中的方法中。当我 Option+Click 方法时它正确显示：

但是，当我在实现此协议的控制器中按 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()
    }
}