[IGNITE-6253] .NET: Replace Doxygen with DocFX for API documentation generation

• Type: Improvement
• Status: Resolved
• Priority: Major
• Resolution: Fixed
• Fix Version/s: 2.3
• Component/s: documentation, platforms
• Labels: .NET
• Assignee: Pavel Tupitsyn
• Reporter: Pavel Tupitsyn
• Created: 04/Sep/17 09:44
• Updated: 07/Sep/17 11:30
• Resolved: 07/Sep/17 11:30

Description

Doxygen has recently became very slow on our code base (can take up to 30 minutes), and there seems to be no solution to this problem. There are other issues: documentation is a bit ugly, customization possibilities are limited, C# is not a first-class citizen there.

DocFX looks like an obvious replacement:

• It is a go-to documentation generator for .NET (included in .NET Foundation)
• Documentation looks nice (MSDN-like) out of the box
• Migration seems to be easy enough

Issue Links

• is depended upon by: IGNITE-6267 .NET: Get rid of Doxygen-specific files
• links to: GitHub Pull Request #2588