DocFX `Недопустимое значение cref "!:Exception" обнаружено в комментариях с тройной косой чертой для` в Azure Pipeline ⇐ C#

[Anonymous]

У меня возникла проблема с DocFx при работе в конвейере Azure, где DocFx сообщает о недопустимом значении Cref "!:Exception", обнаруженном в комментариях с тройной косой чертой для для этого и многих стандартных объектов .net. >
Это происходит только в конвейере Azure, а не при запуске docfx /docfx.json локально в терминале разработчика Visual Studio.
Я использую классический конвейер и тип задачи «Создание документации DocFx».

< /p>
Эквивалент YAML:

Код: Выделить всё

- task: chrismason.vsts-docfxtasks.docfx-extension-build-task.DocFxTask@0
displayName: 'Create Top Level Documentation'
inputs:
solution: src//docfx.json
docfxOptions: /Documentation/docfx.json

Я NuGet восстанавливаю проект и собираю его на предыдущем этапе, хотя если я удалю этап сборки, это не повлияет на выходные данные документации сборки.
Я заменил название проекта на , чтобы это сообщение было общедоступным.
Docfx.json > файл выглядит так, хотя с правильными именами проектов и небольшой путаницей имен.

Код: Выделить всё

{
"metadata": [
{
"src": [
{
"files": [
"Project1/Project1.csproj",
"Project2/Project2.csproj",
"Project3/Project3.csproj"
],
"exclude": [ "**/bin/**", "**/obj/**" ],
"src": ".."
}
],
"dest": "api",
"disableGitFeatures": false,
"disableDefaultFilter": false
}
],
"build": {
"content": [
{
"files": [
"toc.yml",
"index.md",
"api/**.md",
"api/**.yml",
"api/toc.yml"
]
}
],
"dest": "website",
"fileMetadataFiles": [],
"globalMetadata": {
"_appTitle": "???? Core Library",
"_appName": "???? Core Library",
"_appFooter": "Copyright ????",
"_appFaviconPath": "resources/ico/favicon.ico",
"_appLogoPath": "resources/png/logo.png",
"_disableNavbar": false,
"_disableBreadcrumb": false,
"_disableToc": false,
"_disableContribution": true,
"_enableSearch": true,
"pdf": false,
"generatesAppendices": "true"
},
"globalMetadataFiles": [],
"resource": [
"Resources/ico/favicon.ico",
"Resources/png/logo.png",
],
"template": [
"default",
"modern"
],
"postProcessors": [],
"markdownEngineName": "markdig",
"noLangKeyword": false,
"keepFileLink": false,
"cleanupCacheHistory": false,
"disableGitFeatures": false
}
}

Все проекты .NetCore 8.0


Подробнее здесь: https://stackoverflow.com/questions/790 ... s-for-on-a