XcodeでSwift1.xのコードを変換すると、文書コメント(関数やメソッドなどのコメント)も一緒にコンバートされるので気づいた人もいると思いますが、文書コメントの記法が変わりました。 以前はパラメータやリターンコード、あとはリスト表記など簡単なものしかありませんでしたが、Swift 2になりmarkdown記法に似た感じに変更され、コメントコマンドもかなり増えてます。 Playgoundのドキュメントレンダリング用とシンボルドキュメントで記法が若干違うのですが、今回シンボルドキュメントの方を中心に書いてみました。 ここにドキュメントがあります。
![Swift 2 で強化されたコメント表記をまとめた #1 - Qiita](https://cdn-ak-scissors.b.st-hatena.com/image/square/00ebaa08b35e75dfdf14f0d3efd1ef2f42a34ca3/height=288;version=1;width=512/https%3A%2F%2Fqiita-user-contents.imgix.net%2Fhttps%253A%252F%252Fcdn.qiita.com%252Fassets%252Fpublic%252Farticle-ogp-background-412672c5f0600ab9a64263b751f1bc81.png%3Fixlib%3Drb-4.0.0%26w%3D1200%26mark64%3DaHR0cHM6Ly9xaWl0YS11c2VyLWNvbnRlbnRzLmltZ2l4Lm5ldC9-dGV4dD9peGxpYj1yYi00LjAuMCZ3PTk3MiZoPTM3OCZ0eHQ9U3dpZnQlMjAyJTIwJUUzJTgxJUE3JUU1JUJDJUI3JUU1JThDJTk2JUUzJTgxJTk1JUUzJTgyJThDJUUzJTgxJTlGJUUzJTgyJUIzJUUzJTgzJUExJUUzJTgzJUIzJUUzJTgzJTg4JUU4JUExJUE4JUU4JUE4JTk4JUUzJTgyJTkyJUUzJTgxJUJFJUUzJTgxJUE4JUUzJTgyJTgxJUUzJTgxJTlGJTIwJTIzMSZ0eHQtYWxpZ249bGVmdCUyQ3RvcCZ0eHQtY29sb3I9JTIzMjEyMTIxJnR4dC1mb250PUhpcmFnaW5vJTIwU2FucyUyMFc2JnR4dC1zaXplPTU2JnM9ZmI2Mzc0ZTk5NDY3ODU2YTdlOWZlMjMyMDU3ODFkYmM%26mark-x%3D142%26mark-y%3D57%26blend64%3DaHR0cHM6Ly9xaWl0YS11c2VyLWNvbnRlbnRzLmltZ2l4Lm5ldC9-dGV4dD9peGxpYj1yYi00LjAuMCZoPTc2Jnc9NzcwJnR4dD0lNDByb3dvcmtzJnR4dC1jb2xvcj0lMjMyMTIxMjEmdHh0LWZvbnQ9SGlyYWdpbm8lMjBTYW5zJTIwVzYmdHh0LXNpemU9MzYmdHh0LWFsaWduPWxlZnQlMkN0b3Amcz1lMjcxODEwYTljODkzY2EyMTcwMzhhMTgxNzJkNzg1Ng%26blend-x%3D142%26blend-y%3D486%26blend-mode%3Dnormal%26s%3Df62b4411b4f2dcef209a26218d3a1f5a)