超全面的Swift编码规范（推荐）

在写文档注释时，尽量保持简洁。

其他注释原则

// 后面要保留空格。

注释必须要另起一行。

使用注释 // MARK: - xoxo 时, 下面一行保留为空行。

class Pirate {
 // MARK: - 实例属性

 private let pirateName: String
 // MARK: - 初始化
 
 init() {
  /* ... */
 }
}