Many languages support documentation comments to allow a generator (like javadoc or doxygen) to generate code documentation by parsing that sam
New in Xcode 8, you can select a method like this
func foo(bar: Int) -> String { ... }
Then press command + option + / or choose "Structure" - "Add documentation" from Xcode's "Editor" menu, and it will generate the following comments template for you:
/// <#Description#>
///
/// - parameter bar: <#bar description#>
///
/// - returns: <#return value description#>