search

WalkerCodeRanger / semver

A semantic version library for .NET fully compliant with v2.0.0 of the spec found at http://semver.org/.
MIT License
297 stars 47 forks source link

Upgrade docfx to fix documentation #85

Open WalkerCodeRanger opened 1 month ago

WalkerCodeRanger commented 1 month ago

The documentation is generated using a cake build script and docfx.console version 2.59.4. That NuGet package has been deprecated, and we are now supposed to use the docfx package. However, it seems to not be a drop in replacement. Switching to that package with the same version causes an exception in the build process.

There appear to be issues with the v3 docs that might be addressed by upgrading docfx. However, upgrading will take a while to figure out.

Resources:

WalkerCodeRanger commented 1 month ago

As part of this, see if we can emit source links in the docs. If it isn't simple to do so, create a separate issue for that.