According to the docs, Jazzy supports Apple's DocC-style symbol links:
Jazzy understands Apple's DocC-style links too, for example:
MyClass/method(param1:) - a link to the documentation for that method that appears as just method(param1:) in the rendered page. <doc:method(_:)-e873> - a link to a specific overload of method(_:). Jazzy can't tell which overload you intend and links to the first one.
That said, how does one obtain the -e873 hash in the example above?
Generating the hashes out of a module's symbol graph is open source. You can dig into swift-docc and read the code that parses the symbol graph and generates the URLs for overloaded symbols. SymbolReference has a bunch of initializers that generate the correct path depending on whether the symbol is a name or kind overload: swift-docc/SymbolReference.swift at main · apple/swift-docc · GitHub
Sorry, I think there may have been some confusion. I'm not a maintainer of Jazzy, I'm simply trying to write some docs for our existing code base, which uses Jazzy. Is there really no tool to get these overload hashes?
You are asking about generating the hashes so I think my confusion is understandable. If you simply need a link to a given overloaded symbol — Xcode's link autocompletion while writing documentation should be sufficient. If you haven't tried adding links in documentation have a look at the DocC WWDC videos, for example https://developer-mdn.apple.com/videos/play/wwdc2021/10166 at around the 17min mark and onwards.
Right, therein lies the problem, because our entire development team is Linux-based! That's part of why we're using Jazzy. Is it possible to get this working in VSCode?