Auto Generate Documentation in Xcode 8 | New Features Xcode 8

How to Auto Generate Documentation in Xcode 8? Apple has come up with a cool new feature of Auto Generate Quick help Documentation. Now that I’ve moved from Swift 2 to 3, I’ve turned my attention to Swift Documentation Markup. Xcode has added some great new features although as you’ll see there’s still work left to be done.

Xcode’s automatic doc-comment skeleton command is super handy. Move the cursor to any symbol and select Editor - Structure - Add Documentation Command-Option-/. Xcode scans the symbol you’ve chosen and adds a doc-comment outline including named parameters and return types if they exist.

You may want to add further comment features like notes, warnings, authorship, dates, and complexity details, but the basics provided by Xcode form a great place to get started.

One Xcode feature that’s just launching is support for treating closure parameters as first-class documentation elements. Xcode’s default documentation doesn’t include closure parameters, as you see in the screenshot that follows.

Swift’s new no labels for function types means that many developers will not include the internal declaration arguments that I use in this example for the action parameter.

By adding internal arguments like _ line: String, you can extend your documentation. Xcode picks up and formats that information into a special closure parameter box, subordinate to the closure that uses that parameter.

Get more info in this book - https://goo.gl/eOsKwF

Sharpkits brings another video for the same.

~References~
Apple Dev - https://developer.apple.com/

~Social~
Web Link: http://www.sharpkits.com/2016/10/20/auto-generate-documentation-in-xcode-8/