✨ Study

• API Design Guidelines

문서화 주석 실습

/// Summary /// ← Blank line /// The textual representation for each item x ← Additional discussion /// is generated by the expression String(x). /// /// - Parameter separator: text to be printed ⎫ /// between items. ⎟ /// - Parameter terminator: text to be printed ⎬ Parameters section /// at the end. ⎟ /// ⎭ /// - Note: To print without a trailing ⎫ /// newline, pass terminator: "" ⎟ /// ⎬ Symbol commands /// - SeeAlso: CustomDebugStringConvertible, ⎟ /// CustomStringConvertible, debugPrint. ⎭ public func print( _ items: Any..., separator: String = " ", terminator: String = "\n")

Promote Clear Usage 3 - 타입 대신 역할에 따라 네이밍하세요

widgetFactory: WidgetFactory supplier: WidgetFactory => 역할 지정

ArgumentLabels 1

• label을 써도 유용하게 구분이 되지 않으면 모든 Label을 생략한다.
• 값을 유지하면서 타입 변환을 하는 경우에는 첫번쨰 argumentLabel을 생략 e.g. Int64(somUInt32) 첫번째 argument는 항상 source of convension

값의 범위가 좁혀지는 경우 label을 붙임

extension UInt32 {
    init(_ value: UInt16)
    init(trucate source: Int64)
}

ArgumentLabels 2