.NET Core Support
This is the first preview of docfx that builds on top of .NET Core!
Docfx is released as a .NET Core Tool starting from v2.60.0-preview.1. .NET 6.x is required to run docfx. To install, run:
dotnet tool update -g docfx --version 2.60.0-preview.1The rest of the command line experience hasn't changed and are backward compatible. We've also updated docfx homepage use the .NET Core version of docfx.
Known Limitations
- Msbuild integration through
docfx.consoleis not supported in this preview. - Plugins like
memberpage,rest.tagpage,rest.operationpageare not supported in this preview. - Supports Windows only. Linux and MacOS are not supported in this preview.
- .NET Framework 4.x is still needed to build from source code in this preview.
What's Changed
🎉 New Features
- feat: Go net6.0 by @tibel in #8238 #8239 #8241 #8254
- feat: Upgrade to .NET Core by @yufeih in #8279
- feat: Ship as global tool to NuGet.org by @yufeih in #8280
- feat: Serve command using ASPNET.Core by @yufeih in #8293
- feat: Deterministic output by @yufeih in #8299
🐞 Bug Fixes
- fix: TOC word-break not being inserted in generic types by @julesabr in #8217
- fix: Crash fixes for CopyInherited by @Sorpirit in #7709
- fix: Fix on DocFX crashes on method parameter by @harriev9 in #8208
🔧 Engineering
- build: Update package references by @tibel in #8139
- build: Upgrade NuGet.Protocol by @YunshuMeg in #8236
- build: Upgrade Newtonsoft.Json from 13.0.1 to 13.0.2 by @YunshuMeg in #8257
- test: Add samples and snapshot testing by @yufeih in #8299
📄 Documentation
New Contributors
- @julesabr made their first contribution in #8217
- @Sorpirit made their first contribution in #7709
- @harriev9 made their first contribution in #8208
- @Lulalaby made their first contribution in #8252
Full Changelog: v2.59.4...v2.60.0-preview.1