Unified documentation links

hi all, there is now an implementation of the proposed link format available in swift-unidoc 0.3.14. this release also includes new resources for how to preview multi-target documentation locally.

https://swiftinit.org/docs/swift-unidoc/guides/quickstart

the proposal has also been updated with future directions.


Future directions

Codelinks to overload families

There is some interest in enabling the codelink format to refer to an entire overload family, rather than a single declaration. This would obviate the need to use hashes in many situations.

We could extend the proposed codelink format to support an explicit syntax for referencing an overload family as a whole. For example, we could use the * character within disambiguation brackets.

/// ``Sequence.joined(separator:) [*]``
5 Likes