Roslyn Compilation error : Unknown command '/noconfig'. ApplyTemplate task not found.

[Foxtrek64]

Hi all,

I followed the quick-start guide on the website, plugged in two projects I want to generate documentation for in my docfx.json file, and ran docfx docfx.json --serve.

Edit: This happens on docfx metadata. I found updated instructions in one of the discussions here.

I do note that my SDK is a little out of date, but I'm not sure if this is enough to cause an issue.

Output from the command line:

> docfx docfx.json --serve
Using .NET Core SDK 8.0.100
Loading project C:/Projects/Tafs.Activities/src/Tafs.Activities.ActivityBase/Tafs.Activities.ActivityBase.csproj
  Determining projects to restore...
  All projects are up-to-date for restore.
__________________________________________________
Project "C:\Projects\Tafs.Activities\src\Tafs.Activities.ActivityBase\Tafs.Activities.ActivityBase.csproj" (Compile;CoreCompile target(s)):

ROSLYNCODETASKFACTORYCSHARPCOMPILER : error : Unknown command '/noconfig'.
C:\Users\duad\.nuget\packages\remora.sdk\3.0.1\Sdk\Sdk.targets(250,9): error : The source file for this compilation can be found at: "C:\Users\duad\AppData\Local\Temp\MSBuildTempdduanne\tmpfc21cd443b384c19936b2fa0f85c4f8d.tmp"
C:\Users\duad\.nuget\packages\remora.sdk\3.0.1\Sdk\Sdk.targets(250,9): error MSB4036: The "ApplyTemplate" task was not found. Check the following: 1.) The name of the task in the project file is the same as the name of the task class. 2.) The task class is "public" and implements the Microsoft.Build.Framework.ITask interface. 3.) The task is correctly declared with <UsingTask> in the project file, or in the *.tasks files located in the "C:\Program Files\dotnet\sdk\8.0.100" directory.
Done building project "Tafs.Activities.ActivityBase.csproj" -- FAILED.

docfx.json file:

{
  "metadata": [
    {
      "src": [
        {
          "src": "../Tafs.Activities",
          "files": [
            "**/*.csproj"
          ]
        },
        {
          "src": "../Tafs.Applications",
          "files": [
            "**/*.csproj"
          ]
        }
      ],
      "dest": "api"
    }
  ],
  "build": {
    "content": [
      {
        "files": [
          "**/*.{md,yml}"
        ],
        "exclude": [
          "_site/**"
        ]
      }
    ],
    "resource": [
      {
        "files": [
          "images/**"
        ]
      }
    ],
    "output": "_site",
    "template": [
      "default",
      "modern",
      "templates/singulinkfx"
    ],
    "globalMetadata": {
      "_appName": "RPA Docs",
      "_appTitle": "RPA Docs",
      "_enableSearch": true,
      "pdf": true
    }
  }
}

I think it's worth noting that these projects do compile by themselves, both with Visual Studio using dotnet build. I mention both because I've had times in the past where one has worked but not the other.

[Foxtrek64]

Current workaround: I'm using the compiled .dlls for src references.

[filzrev]

Try to use .NET 8 SDK 8.0.200 or later.

ROSLYNCODETASKFACTORYCSHARPCOMPILER : error : Unknown command '/noconfig'.

As far as I knows. above error occurred when following condition met.

1. RoslynCodeTaskFactory based MSBuild task is used.
2. Project that targets both .NET and .NET Framework.

[Foxtrek64]

Some of the projects in the referenced solution cross-target netfx and netcore. Is there a way I can use docfx just to use the net8 version? All support net8.

[filzrev]

Is there a way I can use docfx just to use the net8 version? All support net8.

Set TargetFramework at metadata's properties section.
https://dotnet.github.io/docfx/reference/docfx-json-reference.html?q=msbuild#properties

[Foxtrek64]

Using "TargetFramework": "net8.0" in combination with the compiled binaries, I get a bunch of errors for Net461 assemblies not being found. Does this not affect that?

Loading assembly C:/projects/Tafs.Activities/src/Tafs.Activities.ActivityBase/bin/Release/net461/System.Collections.Specialized.dll
warning: InvalidAssemblyReference: Unable to resolve assembly reference System.IO.Ports, Version=4.0.3.0, Culture=neutral, PublicKeyToken=cc7b13ffcd2ddd51
warning: InvalidAssemblyReference: Unable to resolve assembly reference System.Data.SqlClient, Version=4.6.1.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a
warning: InvalidAssemblyReference: Unable to resolve assembly reference System.Data.Odbc, Version=4.0.2.0, Culture=neutral, PublicKeyToken=cc7b13ffcd2ddd51
warning: InvalidAssemblyReference: Unable to resolve assembly reference System.Data.OleDb, Version=4.0.1.1, Culture=neutral, PublicKeyToken=31bf3856ad364e35

[filzrev]

It seems to be related to #9459.

Currently there is no workaround.
So generated API metadata might be incomplete for types that using warning assembly types.

To suppress these warnings. set following rules in docfx.json.

{
  "rules": {
    "InvalidAssemblyReference": "info"
  }
}