I wanted to generate some documentation for my Swift projects, but wasn't satisfied with the available tools. Here's what I came up with!
If you like it, it would be wonderful if you would purchase a compiled copy. Even if you just download and build it yourself, it would show appreciation for my work in developing this. If you're strapped for cash, unsatisfied with the product, or just otherwise just don't want to, that's fine too. You are welcome to download a copy of the source and build it yourself at no charge.
If you have any ideas or enhancements you'd like to contribute, please make a pull request.
- Simply open an Xcode project written in Swift (there's no reason it shouldn't be able to work in any other language support by Xcode, but only Swift has been tested/supported officially)
- Rename the project if desired. This will change the title of the documentation when exporting.
- Select the minimum access level that should be accounted for during export.
- The exported items popup will display the resulting selection. This is a read only output.
- Determine if you want a single page of documentation or a separate page for each entity accessible on the global namespace.
- Determine if you want raw markdown output, a folder of HTML for easy hosting wherever, or a Dash docset (note that the Dash docset inherently requires a single file of output).
- Hit export and save your documentation!