[SR-15414] DocC can't refer to Identifiable `id` property about swift-docc

[d-ronnqvist]

Feel free to reopen this issue and add more examples if there are cases where this doesn't work with the latest main or 5.9 builds of DocC.

[Kyle-Ye]

Reproduced.

Using the sample code below, and reference these property in DocC's Topics.

A/id and C/description are fine. B/id and C/id are complaining -> "Topic reference 'B/id' couldn't be resolved to known documentation"

public struct A {
    public var id: String
}

public struct B: Identifiable {
    public var id: String
}

public struct C: CustomStringConvertible, Identifiable {
    public var id: String
    public var description: String
}

I'm investigating the code to find what's wrong.

[JeneaVranceanu]

Xcode Version 13.3 (13E113)

Probably related:

Topic reference 'Web3/Utils/erc20ABI' couldn't be resolved. No local documentation matches this reference.

Breakdown

erc20ABI is a public static var declared in an extension of Web3.Utils which is a struct.
The Web3.Utils is declared in an extension.

public struct Web3 {
}

extension Web3 {
    public struct Utils {
    }
}

extension Web3.Utils {
    /// Note that this variable does have a documentation comment, but it's not resolved.
    public static var erc20Abi = "some value here"
}

But at the same time, this variable is resolved by Xcode and by Cmd+Click can navigate to the declaration source.

[d-ronnqvist]

All 3 examples in this thread work for me in the latest main and 5.9 builds of DocC.