Just submitted an updated version of Swift Documentation Markup to the iBooks and Leanpub stores. This new version includes revisions to my coverage of the excellent Jazzy documentation tool and new coverage of the VVDocumenter Xcode plugin, which automatically adds documentation templates to your code when you type ///.
Jazzy now supports some markup parsing, including parameters. Compare the output from the new version, shown here:
with the old output here:
It’s a fantastic and welcome improvement.
The VVDocumenter works by adding documentation templates to any symbol when you type /// (three forward slashes) before its declaration.
Just fill in the boilerplate with your details. VVDocumenter automatically adds placeholder tokens using <# and #> so they highlight in your source editor.
Note that as with any plug-in, you need to keep VVDocumenter up to date so it works with each revision and beta of Xcode.