inheritdoc should support built-in types

[tdmowrer]

Operation System: (Windows or Linux or MacOS)
macOS

DocFX Version Used:
2.51

Template used: (default or statictoc or contain custom template)
default

Steps to Reproduce:

1. Add <inheritdoc/> to a method defined in a system interface, like IEnumerable<T>.GetEnumerator or GetHashCode.
2. Execute DocFX

Expected Behavior:
Documentation is generated.

Actual Behavior:
No documentation is generated.

This seems to be because <inheritdoc/> doesn't support system types. However, <see cref={some system type}/> does work, so DocFX seems to be capable of this.

[DanielsCode]

Hi,

we have the same problem. Are there any updates?

Cheers,
Daniel

[KalleOlaviNiemitalo]

https://xref.docs.microsoft.com/query?uid=System.Collections.Generic.IEnumerable`1.GetEnumerator returns an object that has hrefand summary properties but does not have returns, remarks, etc.. So if inheritdoc should copy all of those, then it would have to get them from somewhere else.

There are also license concerns. If your build system embeds copyrighted material from Microsoft's xref service to your product documentation daily, and Microsoft changes the license terms some day, then how will you notice? The xref service is not like a NuGet package where you can keep fetching the old version with the old license terms.