Skip to content

v2.64.0

Compare
Choose a tag to compare
@yufeih yufeih released this 30 Mar 05:30
· 1272 commits to main since this release
6a1e6d7

C# documentation comment link enhancements

This release improves link generation for C# documentation comment in a couple of areas:

  • Links to base class libraries are generated automatically without using the xref service or extra config. This is done by calculating the references to APIs hosted on https://learn.microsoft.com/dotnet/api using an URL pattern offline.
  • View source is now available for assemblies as input if
    • The assembly enables SourceLink
    • A PDB file exist next to the assembly file.
  • Links to types in dependency assemblies produces URLs pointing to the API source code location if:
    • The dependency assembly enables SourceLink
    • A PDB file exist next to the assembly file.
  • <see langword=""> now properly resolves to URLs pointing to https://learn.microsoft.com.

MemberPage as a first class feature

The memberpage plugin is now replaced by a first-class feature using the experimental { "memberLayout": "SeparatePages" } config. See this example on how to enable the behavior in docfx.json.

NOTE: This new feature has been manually tested for the default templates, the modern template and the statictoc template, but there might be glitches in some edge cases.

Sunset DFM markdown engine

The MarkdownLite and DFM markdown engine is removed from docfx in this release. DFM users are encouraged to update to markdig for a commonmark compliant markdown parser, a rich markdown extension eco-system and better performance.

What's Changed

💥 Breaking Changes

🎉 New Features

  • feat: compute mslearn symbol URL by @yufeih in #8546
  • feat: view source for assemblies using sourcelink by @yufeih in #8548
  • feat: resolve langword to URLs by @yufeih in #8550
  • feat: add allowCompilationErrors option by @yufeih in #8554
  • feat: memberpage plugin -> memberLayout.SeparatePages by @yufeih in #8569

🐞 Bug Fixes

📄 Documentation

Full Changelog: v2.63.1...v2.64.0