Как создавать ссылки на код с пользовательским текстом ссылки в комментариях к документации?

Я портирую библиотеку приложений с Java на C#. В документации Java есть места, которые ссылаются на конкретную ссылку на код, используя пользовательский текст. Например:

Suffix --> {@link DataOutput#writeString String}

Я попытался использовать аналогичный подход в комментариях к документации XML...

Suffix --&gt; <see cref="DataOutput.WriteString(string)">String</see>

... но вся эта ссылка просто исчезает как из Intellisense, так и из сгенерированной документации, когда я пытаюсь это сделать таким образом. Вопрос в том, как создать аналогичные ссылки на код с пользовательским текстом, используя комментарии к документации.NET XML в C#? Если нет способа сделать это, каков рекомендуемый обходной путь?

Если это имеет значение, мы экспериментируем с использованием генератора кода DocFx.

1 ответ

Решение

Вы можете использовать синтаксис перекрестных ссылок DocFX: [String](xref:DataOutput.WriteString(System.String)),

Смотрите: http://dotnet.github.io/docfx/tutorial/links_and_cross_references.html

Другие вопросы по тегам