xcode - 带有委托协议的 Headerdoc - 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()
    }
}