Are there updates on using Swift-DocC with multiple targets?

I noticed that this has been talked about in both of the following threads:

However, the latest reply (out of both threads) is September 2023. Are there any updates on these use cases? Are they able to be used currently, or not?

2 Likes

Yes. There has been a significant progress on building out support for both linking between documentation for multiple targets and hosting documentation for multiple targets together.

The two main reason for not posting an update in the forums yet is that the experience was rather limited until most of the pieces was in place and that it required running multiple commands in a script to build a combined documentation archive with links between targets.

Render combined navigation for merged documentation archives by mportiz08 · Pull Request #877 · swiftlang/swift-docc-render · GitHub will address one of the last limitations to a early, initial experience and Add initial experimental support for combined documentation for multiple targets by d-ronnqvist · Pull Request #84 · swiftlang/swift-docc-plugin · GitHub will make it convenient to build a combined documentation archive with links between targets.

I'll post a real update in the forums when both those pieces have landed, which will make it the first early version that's usable end-to-end and that solves some of the most common use cases.

5 Likes