在Xcode 8公布的新功能中，我们可以看到
“自动生成快速帮助文档”：
像我们can learn on this article from NSHipster 这样的手动代码文档到此结束了吗？
有人能概括一下这个新功能的优缺点吗？ Does it replace tools like Jazzy?
我找不到有关新功能的更多信息。
【问题讨论】：
这是指 Xcode 8（及更高版本）功能，您可以在其中选择这样的方法：
func foo(bar: Int) -> String { ... }
... 然后按 ⌘+option+/ （或从 Xcode 的“编辑器”中选择“结构”»“添加文档” ”菜单），它将为您生成以下 cmets 模板：
/// <#Description#>
///
/// - parameter bar: <#bar description#>
///
/// - returns: <#return value description#>
它只是方便快速帮助文档的编写。
注意，虽然这种行为随着时间的推移而发生了一些变化，但当您尝试这样做时，Xcode 可能会特别注意光标必须位于的位置。例如，光标必须位于函数名称中的某个位置，在我上面的示例中，foo 才能工作。或者直接双击函数名然后按⌘+option+/
您询问此功能是否会取代 Jazzy 等工具。
不，它不会取代 Jazzy 或类似工具。除此之外，Jazzy 从这个内联文档创建独立的 HTML 文档。因此，这只是一个问题，您是否出于任何原因需要 Jazzy 的这些独立输出。如果是这样，请将 Jazzy（或类似工具）与此集成文档结合使用。如果不需要（即，您只是在 Xcode IDE 中查找文档），则不需要 Jazzy。
【讨论】：
@IBAction 方法混淆了。但它适用于 Objective-C 和 Swift。如果您仍然遇到问题并且尝试了重启 Xcode 和/或重启机器的常规蹩脚程序，您可能只想发布关于此测试版软件的错误报告。
sudo /usr/libexec/xpccachectl 并在 Mac 或任何其他 Xcode 扩展工作之前重新启动你的 Mac。请参阅 Xcode 8 发行说明。
这很可能与以下事实有关
即在德语键盘上，'/' 是 shift+7，按 alt+cmd+shift-7 不起作用。如果你指定，即 cmd+shift+opt+d，它工作得很好。
快捷方式'///'，不幸的是现在也不起作用，可能是由于旧的 XCode 插件 VVDocumenter 使用了这个快捷方式。
很棒的功能，Apple 方面糟糕的 QA。
【讨论】：