在 Xcode 8 中记录代码 [关闭]

【问题标题】：Documenting code in Xcode 8 [closed]在 Xcode 8 中记录代码 [关闭]
【发布时间】：2017-02-03 14:50:03
【问题描述】：

我看到 Apple 的 HeaderDoc User Guide 已被标记为“Retired Document”，并附有此说明：

重要提示：本文档可能不代表当前开发的最佳实践。下载链接和其他资源可能不再有效。

本文档最后一次更新是在 5 月。那么......现在在 Xcode 8 中记录代码的最佳实践是什么？我没有找到有关此的更多信息。

【问题讨论】：

【解决方案1】：

Apple 在 xCode 8 中添加了新功能，以便在您的代码中轻松添加文档。为此，只需将光标移动到任何符号并选择编辑器 > 结构 > 添加文档 (Command-Option-/)。 Xcode 扫描您选择的符号并添加一个文档注释大纲，包括命名参数和返回类型（如果存在）。

【讨论】：