Join GitHub today
GitHub is home to over 31 million developers working together to host and review code, manage projects, and build software together.Sign up
Reference to Task.Delay(int) not resolved #4164
Steps to Reproduce:
generated yml content:
I also tried to reference
I really fear that using a xrefService via the internet for each and every API that we reference somewhere in our documentation will significantly slow down the build time. Also, if the internet breaks, our builds break.
Is there no reliable way to have an offline build?
@bitbonk I agree this is a valid concern. v3 has a similar idea to download needed xrefMap in a pre step to avoid call API during build. This will make the build input clear.
Fow now, xrefService is the source of truth that contains the full data. XrefMap on docs site contains only partial data. The tradeoff here is: If I only need to resolve few BCL UIDs, I want to use xrefService instead of preparing the huge xrefMap beforehand. If I need to resolve a lot, xrefMap would be better.
Maybe you can try running docfx append
Or you can try this xrefmap.yml for test (which works for me):
### YamlMime:XRefMap references: - uid: System.Threading.Tasks.Task.Delay(System.Int32) name: Delay(Int32) href: https://docs.microsoft.com/dotnet/api/system.threading.tasks.task.delay#System_Threading_Tasks_Task_Delay_System_Int32_ fullName: System.Threading.Tasks.Task.Delay(Int32)