Hey,
I am currently struggling to find out why symbol graphs of extended types are not being picked up by docc when converting a .docc file.
My setup is not a standard setup, therefore let me explain it a little bit. My package consists of multiple targets for multiple destinations. Since it is not yet supported, at least as far as I know, to generate a documentation for multiple destinations with the official docc SPM plugin I resort back to xcodebuild
to build all targets for all supported platforms and emit their symbol graphs.
Later on I collect all of the symbol graphs with --additional-symbol-graph-dir
and merge them together. In the documentation I then reference the targets and end up seeing the documentation of the targets in the documentation sidebar.
The only issue I see is that symbol graphs for extended types are not picked up and therefore do not land in the final documentation. For example I have a symbol graph named MyTarget@SwiftUICore.symbols.json
, which contains the description of SwiftUI
types I extend in MyTarget
. It is located in the directory that I pass via --additional-symbol-graph-dir
- but non of the symbols in that file are visible in the final generated documentation. Is there some special handling needed to get those symbols into the final documentation ? Can I reference them somehow, similar how I did it with the targets in my package ?
Thanks a lot for any help !