[cherryblossom00]

This reminds me of Swift/Xcode's documentation comments:

  /// Does something.
  ///
  /// - Parameters:
  ///   - bar: A description for bar.
  ///   - baz: A description for baz.
  ///
  /// - Returns: Something fancy.
  /// - Throws: Throws `SomeErrorType` if `bar` is invalid.
  func foo(bar: String, baz: Int) throws -> Bool { /* ... */ }