https://www.youtube.com/watch?v=SKXNAdk3ot0
今回から新たに、Swift 公式のガイドライン API Design Guidelines
に入っていきます。
これまでに見てきた Swift.org の About Swift
が終わって、当初からの題材である The Swift Programming Language
を眺めてみようかと思ったのですけれど、その前に API Design Guidelines
を確認しておくとより有意義な機会になるような気がして、まずはここから初めていこうと思います。よろしくお願いいたしますね。
—————————————————————————————————— 熊谷さんのやさしい Swift 勉強会 #12
00:00 開始 00:49 この勉強会の趣旨 01:58 この勉強会における心持ち 03:30 Swift API Design Guidelines 05:28 Objective-C っぽさ 06:50 目的 09:06 Cocoa の命名規則 11:33 Objective-C との相互運用 13:41 基本事項 14:25 使用時の明瞭さを最重視 15:41 API は短さよりも明瞭さを意識 18:06 名前付の文化の違い 22:21 文字列の長さ表現にみる文化の違い 25:04 ドキュメントコメント 26:39 コメントとドキュメントコメント 27:49 ドキュメントコメントとクイックヘルプ 31:14 ドキュメントコメントは API の設計に良い影響を与える 33:53 ドキュメントコメントの概要 35:39 ドキュメントコメントの例 38:01 コメントは実装の道しるべ 48:00 何をするのか、何を返すのか 48:30 Swift の関数は原則、戻り値を返す 50:59 添字構文における概要説明 52:57 イニシャライザーにおける概要説明 53:31 その他における概要説明 54:45 シンボル・ドキュメンテーション・マークアップ 58:32 次回の展望 ——————————————————————————————————