[SR-15431] Support DocC references to symbols defined in another module

[Mordil]

Previous ID	SR-15431
Radar	rdar://79049385
Original Reporter	@Mordil
Type	New Feature

Additional Detail from JIRA

Votes	19
Component/s	Swift-DocC
Labels	New Feature
Assignee	None
Priority	Medium

md5: c3c52c8ed342d1b0fea2c443bcf8f543

Issue Description:

As a database driver author, I rely heavily on SwiftNIO for the architecture of my driver, and users of my driver should be familiar with many of the concepts and types defined by SwiftNIO that I also expose.

When I write symbol documentation or articles, I would like the ability to reference those types, to enrich the exploration of documentation with Xcode.

The syntax I would find the least surprising is having to prepend the module's name at the start, such as ``SlothCreator/Habitat``

[Mordil]

This has also been filed in Feedback Assistant with FB9410972

[swift-ci]

Comment by Ellen Shapiro (JIRA)

This would also be super-helpful for us at Apollo GraphQL - we have small sub-libraries for things like handling a SQLite persistence layer and WebSockets that we would love to be able to link to our main lib as well.

[swift-ci]

Comment by Alexey Ivashko (JIRA)

+1 on this. I distribute internal frameworks as one package but as several different libraries in order to use only the code I needed for my targets. Referencing another module from my own would be such a pleasure, because I have several "protocol" only frameworks that have "concrete" frameworks implementations. And also, sometimes I would like to reference existing system framework documentation in order to guide user to fully learn about my api

[swift-ci]

Comment by Martin Heinrich (JIRA)

+1 for this request
Work is split into multiple modules and documentation needs to mention types that are referenced or extended. This is the case for modules under ones control, but even more for third party modules used or operating system frameworks.

[slashmo]

+1 on this as well. We'd also need to cross-reference across targets in the Distributed Tracing repos.

[swift-ci]

Comment by Akos Polster (JIRA)

+1 on this. We are distributing an SDK as a set of frameworks. Documenting them as a single unit would be great.

[TheothermeinGit]

any news for this ?

[flockoffiles]

I would also be very much interested in having this support implemented.

[spnkr]

👍 . This is the only thing preventing me from using DocC for my documentation.

[Vitalii-Gozhenko]

+1 for this feature. Sometimes it is incredible usable

[proj-sashido]

+1 for this feature!