Links and Cross References

[VaclavElias]

I have 2 questions.

Question 1

Is this page https://dotnet.github.io/docfx/docs/links-and-cross-references.html purposely removed from the docs? This link is not showing up in the docs. Maybe there should be dashes instead of underscores?

Question 2

How can I change the GitHub url branch when cross referencing, in this example the cref Entity https://stride3d.github.io/stride-community-toolkit/api/Stride.CommunityToolkit.Engine.EntityExtensions.html.

When the docs are built through GitHub Action

https://github.com/stride3d/stride-community-toolkit/blob/main/src/Stride.CommunityToolkit/Engine/EntityExtensions.cs#L7

this cref below:

using Stride.CommunityToolkit.Scripts;
using Stride.Engine;

namespace Stride.CommunityToolkit.Engine;

/// <summary>
/// Provides extension methods for <see cref="Entity"/> to simplify common operations.
/// </summary>
public static class EntityExtensions
{
}

The Entity link is pointing here https://github.com/stride3d/stride/blob/main/sources/engine/Stride.Engine/Engine/Entity.cs which doesn't exist, we don't have main branch. Note I didn't set this up. Not sure where the link is coming from and how your fallback works.

The correct link is with master branch not the main branch so it should be https://github.com/stride3d/stride/blob/master/sources/engine/Stride.Engine/Engine/Entity.cs

The Stride Community Toolkit is here https://github.com/stride3d/stride-community-toolkit while the referenced entity Entity is referenced through NuGet package Stride.Engine. The Stride repo is here https://github.com/stride3d/stride

Any suggestions how to resolve this? Thank you.

[VaclavElias]

Going through the docs, I wonder, if I should add this to docfx.json?

    "xref": [
      "https://stride-doc-staging.azurewebsites.net/latest/en/xrefmap.yml"
    ]

[VaclavElias]

It did nothing.