Epic: NSwag v12

[RicoSuter]

Next major version v13: #1700

v12 Changelog

Planning

Epics:

• New template engine (enabled by default): Epic: Replace template engine #263
• Api explorer: Epic: Use Asp.Net Core Api Explorer for Swagger generation #999
• OpenAPI 3.0.0 support (still some problems)
• Change default settings: Change default settings #1719

Fixed issues:

• See Add IDocumentProvider service and its implementation #1658 : Separately, the registrar currently has a "last one wins" semantic. Not sure we should require distinct DocumentName properties in the initial release. Wouldn't that be a breaking change? (already enabled)
• Also see: Epic: NJsonSchema v10 NJsonSchema#507

[Bomret]

I think it ld be good to use System.DateTimeOffset for date time types. So you get the UTC offset and thus globally unique dates.

[RicoSuter]

@Bomret good point. We'll check this as soon as the major release is imminent... will still take some time and changing the defaults is simple.