dotnet-core | docfx | documentation

.netstandard2.0 Project - DocFX MSBuild Error

If you are facing issues when trying to generate documentation for your .netstandard2.0 project. Try the solution mentioned in this post.

Abhith Rajan
Abhith RajanNovember 20, 2018 · 1 min read · Last Updated:

I tried to generate documentation for a .netstandard2.0 project using DocFX.

  • Installed DocFX using chocolatey package.
  • Created a sample project using command line.
docfx init
  • Updated the docfx.json w.r.t the folder structure.
  • Build the website using command line.
docfx --serve

The DocFX site builded but project specific documentation not generated. And there were some warnings like

Warning:No metadata is generated for ProjectName

SDK “Microsoft.NET.Sdk” not found

Solution

Set environment variable MSBuildSDKsPath pointing right to the SDK path. In my case,

C:\Program Files\dotnet\sdk\2.1.500\Sdks

After setting the environment variable, closed the command line (VS Code) and re opened. Tried building the DocFX again and it worked.

Additional Resources

This page is open source. Noticed a typo? Or something unclear?
Improve this page on GitHub


Abhith Rajan

Written byAbhith Rajan
Abhith Rajan is a software engineer by day and a full-stack developer by night. He's coding for almost a decade now. He codes 🧑‍💻, write ✍️, learn 📖 and advocate 👍.
Connect

Is this page helpful?

Related ArticlesView All

Related VideosView All

Using GitHub Wiki for Software Development Documentation

Alex Thissen - Logging, tracing and metrics: instrumenting your .NET Core based cloud applications

Distributed Tracing Made Easy with .NET Core - Jimmy Bogard