記錄代碼在Xcode 8

Question

我已經看到了蘋果的HeaderDoc User Guide已被標記爲「退休的文檔」這個注意事項：

重要提示：本文檔可能不能代表當前開發的最佳實踐。下載和其他資源的鏈接可能不再有效。

本文檔於5月最後更新。那麼......現在在Xcode 8中記錄代碼的最佳實踐是哪些？我沒有找到關於此的更多信息。

Answer 1

Apple在xCode 8中添加了新功能，可以輕鬆地在代碼中添加文檔。爲此，只需將光標移至任何符號，然後選擇編輯器>結構>添加文檔（Command-Option- /）。 Xcode會掃描您選擇的符號，並添加包含命名參數和返回類型（如果存在）的文檔註釋大綱。

有關更多信息： http://ericasadun.com/2016/09/16/xcode-8-document-coding-enhancements/