With the introduction of DocC for generating documentation from source code, is it possible to take the output of DocC and use it as the source of truth for an Apple Help Book (for use inside of a macOS App)?
Is it possible to take the output of DocC and use it as the source of truth for an Apple Help Book?
@matt mentioned:
A DocC is a highly restricted, formalized representation of a very specific type of information.
However I disagree with it. You can create article pages with DocC: Getting Started with Sloths
The problems with using DocC to create Apple Help Book:
DocC documentation only support basic markdown syntax, so your formatting option is limited.
DocC exports the documentation as a single page web app, where Apple Help Book expect individual html files for each help pages. So you would need to automatically generate static html files.
DocC documentation doesn't let you add custom meta tags for indexing or keywords and name for anchors. (Maybe you can use comments in markdown, then automatically generate them from comments. However I'm not sure if comments in markdown would remain in DocC generated file)
You would still need to use Help Indexer to index them.
@matt mentioned:
A help book helps users, whereas DocC displays a programming API to a programmer.
You can definitely meld the two and use DocC generated files as your source of truth, but I would rather do it with other html editors, or a better markdown editor if you prefer the markdown syntax.