If a function annotated with @Reasync has attached documentation, the documentation will appear in the macro expansion but not in the site built by DocC.
This is a compiler issue that affects all peer, member, preamble, and body macros.
Upstream issue: swiftlang/swift#88175
Pending fix: swiftlang/swift#88827
Workaround
Create a markdown file in the DocC archive for the generated peer overload, and DocC will correctly attach it to the symbol when building the site.
Reproduction
/// A function with documentation.
///
/// Documentation appears in the expansion, but not in the DocC site.
@Reasync
public func example() async
{
let x = 1
_ = x
}
If a function annotated with
@Reasynchas attached documentation, the documentation will appear in the macro expansion but not in the site built by DocC.This is a compiler issue that affects all peer, member, preamble, and body macros.
Upstream issue: swiftlang/swift#88175
Pending fix: swiftlang/swift#88827
Workaround
Create a markdown file in the DocC archive for the generated peer overload, and DocC will correctly attach it to the symbol when building the site.
Reproduction