ap0llo/mddocs
### [`v0.5.180`](https://togithub.com/ap0llo/mddocs/releases/tag/v0.5.180)
#### New Features
- [**API Reference:** Add multi-assembly support](#changelog-heading-e9c496871d1b97a64e02bdcc753d108d69668b2d)
- [**Command Line Help:** Order parameters in the "Usage" section](#changelog-heading-e51f605be1cf0641ee7ba48f244e6c87f9d67150)
- [Add .NET 6 support](#changelog-heading-3be5dc45cbd330a0b7948a1dbd49bccd705eca3f)
- [Add .NET 7 Support](#changelog-heading-8c433d32be1774a47cbbda2848209b3152c4fece)
- [Remove support for older versions of .NET and Visual Studio](#changelog-heading-da60e0bc4d1675e64137982a7fab5d91a11882bc)
#### Bug Fixes
- [**Command Line Help:** Disable syntax-highlighting for a command's "Usage" CommandUsageSection](#changelog-heading-14c5ae59328f6e57eeaca9a1d3262a947c7e603d)
- [Make sorting in output consistent across different frameworks](#changelog-heading-4846d07a01641b67c6b098477c7a24d9b78353c9)
- [**API Reference:** Fix rendering of default values of value type and decimal parameters](#changelog-heading-c0a35427ee8cee1966c8c9defffa5d5156af7d58)
#### Breaking Changes
- [The mddocs:apireference:assemblyPath setting was renamed to mddocs:apireference:assemblyPaths and its type was changed from a string to an array of strings](#changelog-heading-e9c496871d1b97a64e02bdcc753d108d69668b2d)
- [The '--assembly' command line parameter of the apireference command has been renamed to '--assemblies'](#changelog-heading-e9c496871d1b97a64e02bdcc753d108d69668b2d)
- [The MdDocs CLI tool now requires at least .NET 6](#changelog-heading-da60e0bc4d1675e64137982a7fab5d91a11882bc)
- [The MdDocs.MSBuild package is now requires at least the .NET 6 SDK (when running on MSBuild Core) or Visual Studio 2022 (when running on "Desktop MSBuild")](#changelog-heading-da60e0bc4d1675e64137982a7fab5d91a11882bc)
#### Details
##### **API Reference:** Add multi-assembly support
- **Breaking Change:** The mddocs:apireference:assemblyPath setting was renamed to mddocs:apireference:assemblyPaths and its type was changed from a string to an array of strings
- **Breaking Change:** The '--assembly' command line parameter of the apireference command has been renamed to '--assemblies'
Add support for rendering API reference documentation for multiple assemblies.
When multiple assemblies are specified, documentation is generated for all types from all assemblies.
The file layout of the output is unchanged and is based on a symbol's name and namespace.
Specifying multiple input assemblies is supported in the MdDocs command line tool but not in the MdDocs MSBuild task which continues to generate documentation for the current project's output assembly.
- Closes: [#112](https://togithub.com/ap0llo/mddocs/issues/112)
- Pull Request: [#123](https://togithub.com/ap0llo/mddocs/pull/123)
- Commit: [`e9c4968`](https://togithub.com/ap0llo/mddocs/commit/e9c496871d1b97a64e02bdcc753d108d69668b2d)
##### **Command Line Help:** Order parameters in the "Usage" section
In a command's "Usage" section, order the parameters.
Positional parameters are ordered by their position, followed by named parameters (required parameters first, then ordered by name) and switch parameters (ordered by name)
- Commit: [`e51f605`](https://togithub.com/ap0llo/mddocs/commit/e51f605be1cf0641ee7ba48f244e6c87f9d67150)
##### Add .NET 6 support
Add support for running MdDocs on .NET 6
- Pull Request: [#180](https://togithub.com/ap0llo/mddocs/pull/180)
- Commit: [`3be5dc4`](https://togithub.com/ap0llo/mddocs/commit/3be5dc45cbd330a0b7948a1dbd49bccd705eca3f)
##### Add .NET 7 Support
Add support for running the MdDocs .NET CLI tool on .NET 7 and add test to ensure MdDocs.MSBuild works on the .NET 7 SDK
- Pull Request: [#226](https://togithub.com/ap0llo/mddocs/pull/226)
- Commit: [`8c433d3`](https://togithub.com/ap0llo/mddocs/commit/8c433d32be1774a47cbbda2848209b3152c4fece)
##### Remove support for older versions of .NET and Visual Studio
- **Breaking Change:** The MdDocs CLI tool now requires at least .NET 6
- **Breaking Change:** The MdDocs.MSBuild package is now requires at least the .NET 6 SDK (when running on MSBuild Core) or Visual Studio 2022 (when running on "Desktop MSBuild")
In the MdDocs CLI tool, remove support for .NET Core 3.1 and .NET 5 which have both reached their end-of-life.
For the MdDocs MSBuild package, remove support for running on the .NET Core 3.1 and .NET 5 SDKs (in the case of MSBuild Core) and versions of Visual Studio older than Visual Studio 2022 (in the case of "Desktop MSBuild")
- Pull Request: [#228](https://togithub.com/ap0llo/mddocs/pull/228)
- Commit: [`da60e0b`](https://togithub.com/ap0llo/mddocs/commit/da60e0bc4d1675e64137982a7fab5d91a11882bc)
##### **Command Line Help:** Disable syntax-highlighting for a command's "Usage" CommandUsageSection
Add Markdown info string "txt" to usage sections to prevent (wrong) syntax highlighting from being applied to it.
- Commit: [`14c5ae5`](https://togithub.com/ap0llo/mddocs/commit/14c5ae59328f6e57eeaca9a1d3262a947c7e603d)
##### Make sorting in output consistent across different frameworks
.NET 5 changed the default sorting behavior for strings causing the output of MdDocs to be different when running on net5.0 vs. running on earlier .NET Core versions or .NET Framework.
Make sorting consistent by explicitly using "Ordinal" comparisons for all sort operations.
- See Also:
- Commit: [`4846d07`](https://togithub.com/ap0llo/mddocs/commit/4846d07a01641b67c6b098477c7a24d9b78353c9)
##### **API Reference:** Fix rendering of default values of value type and decimal parameters
Fixes rendering of value type and decimal parameters in method default values
Thanks [@madelson](https://togithub.com/madelson)
- Pull Request: [#205](https://togithub.com/ap0llo/mddocs/pull/205)
- Commit: [`c0a3542`](https://togithub.com/ap0llo/mddocs/commit/c0a35427ee8cee1966c8c9defffa5d5156af7d58)
Configuration
📅 Schedule: Branch creation - At any time (no schedule defined), Automerge - At any time (no schedule defined).
🚦 Automerge: Disabled by config. Please merge this manually once you are satisfied.
♻ Rebasing: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.
🔕 Ignore: Close this PR and you won't be reminded about this update again.
[ ] If you want to rebase/retry this PR, check this box
This PR has been generated by Mend Renovate. View repository job log here.
This PR contains the following updates:
0.4.179->0.5.180Release Notes
ap0llo/mddocs
### [`v0.5.180`](https://togithub.com/ap0llo/mddocs/releases/tag/v0.5.180) #### New Features - [**API Reference:** Add multi-assembly support](#changelog-heading-e9c496871d1b97a64e02bdcc753d108d69668b2d) - [**Command Line Help:** Order parameters in the "Usage" section](#changelog-heading-e51f605be1cf0641ee7ba48f244e6c87f9d67150) - [Add .NET 6 support](#changelog-heading-3be5dc45cbd330a0b7948a1dbd49bccd705eca3f) - [Add .NET 7 Support](#changelog-heading-8c433d32be1774a47cbbda2848209b3152c4fece) - [Remove support for older versions of .NET and Visual Studio](#changelog-heading-da60e0bc4d1675e64137982a7fab5d91a11882bc) #### Bug Fixes - [**Command Line Help:** Disable syntax-highlighting for a command's "Usage" CommandUsageSection](#changelog-heading-14c5ae59328f6e57eeaca9a1d3262a947c7e603d) - [Make sorting in output consistent across different frameworks](#changelog-heading-4846d07a01641b67c6b098477c7a24d9b78353c9) - [**API Reference:** Fix rendering of default values of value type and decimal parameters](#changelog-heading-c0a35427ee8cee1966c8c9defffa5d5156af7d58) #### Breaking Changes - [The mddocs:apireference:assemblyPath setting was renamed to mddocs:apireference:assemblyPaths and its type was changed from a string to an array of strings](#changelog-heading-e9c496871d1b97a64e02bdcc753d108d69668b2d) - [The '--assembly' command line parameter of the apireference command has been renamed to '--assemblies'](#changelog-heading-e9c496871d1b97a64e02bdcc753d108d69668b2d) - [The MdDocs CLI tool now requires at least .NET 6](#changelog-heading-da60e0bc4d1675e64137982a7fab5d91a11882bc) - [The MdDocs.MSBuild package is now requires at least the .NET 6 SDK (when running on MSBuild Core) or Visual Studio 2022 (when running on "Desktop MSBuild")](#changelog-heading-da60e0bc4d1675e64137982a7fab5d91a11882bc) #### Details ##### **API Reference:** Add multi-assembly support - **Breaking Change:** The mddocs:apireference:assemblyPath setting was renamed to mddocs:apireference:assemblyPaths and its type was changed from a string to an array of strings - **Breaking Change:** The '--assembly' command line parameter of the apireference command has been renamed to '--assemblies' Add support for rendering API reference documentation for multiple assemblies. When multiple assemblies are specified, documentation is generated for all types from all assemblies. The file layout of the output is unchanged and is based on a symbol's name and namespace. Specifying multiple input assemblies is supported in the MdDocs command line tool but not in the MdDocs MSBuild task which continues to generate documentation for the current project's output assembly. - Closes: [#112](https://togithub.com/ap0llo/mddocs/issues/112) - Pull Request: [#123](https://togithub.com/ap0llo/mddocs/pull/123) - Commit: [`e9c4968`](https://togithub.com/ap0llo/mddocs/commit/e9c496871d1b97a64e02bdcc753d108d69668b2d) ##### **Command Line Help:** Order parameters in the "Usage" section In a command's "Usage" section, order the parameters. Positional parameters are ordered by their position, followed by named parameters (required parameters first, then ordered by name) and switch parameters (ordered by name) - Commit: [`e51f605`](https://togithub.com/ap0llo/mddocs/commit/e51f605be1cf0641ee7ba48f244e6c87f9d67150) ##### Add .NET 6 support Add support for running MdDocs on .NET 6 - Pull Request: [#180](https://togithub.com/ap0llo/mddocs/pull/180) - Commit: [`3be5dc4`](https://togithub.com/ap0llo/mddocs/commit/3be5dc45cbd330a0b7948a1dbd49bccd705eca3f) ##### Add .NET 7 Support Add support for running the MdDocs .NET CLI tool on .NET 7 and add test to ensure MdDocs.MSBuild works on the .NET 7 SDK - Pull Request: [#226](https://togithub.com/ap0llo/mddocs/pull/226) - Commit: [`8c433d3`](https://togithub.com/ap0llo/mddocs/commit/8c433d32be1774a47cbbda2848209b3152c4fece) ##### Remove support for older versions of .NET and Visual Studio - **Breaking Change:** The MdDocs CLI tool now requires at least .NET 6 - **Breaking Change:** The MdDocs.MSBuild package is now requires at least the .NET 6 SDK (when running on MSBuild Core) or Visual Studio 2022 (when running on "Desktop MSBuild") In the MdDocs CLI tool, remove support for .NET Core 3.1 and .NET 5 which have both reached their end-of-life. For the MdDocs MSBuild package, remove support for running on the .NET Core 3.1 and .NET 5 SDKs (in the case of MSBuild Core) and versions of Visual Studio older than Visual Studio 2022 (in the case of "Desktop MSBuild") - Pull Request: [#228](https://togithub.com/ap0llo/mddocs/pull/228) - Commit: [`da60e0b`](https://togithub.com/ap0llo/mddocs/commit/da60e0bc4d1675e64137982a7fab5d91a11882bc) ##### **Command Line Help:** Disable syntax-highlighting for a command's "Usage" CommandUsageSection Add Markdown info string "txt" to usage sections to prevent (wrong) syntax highlighting from being applied to it. - Commit: [`14c5ae5`](https://togithub.com/ap0llo/mddocs/commit/14c5ae59328f6e57eeaca9a1d3262a947c7e603d) ##### Make sorting in output consistent across different frameworks .NET 5 changed the default sorting behavior for strings causing the output of MdDocs to be different when running on net5.0 vs. running on earlier .NET Core versions or .NET Framework. Make sorting consistent by explicitly using "Ordinal" comparisons for all sort operations. - See Also:Configuration
📅 Schedule: Branch creation - At any time (no schedule defined), Automerge - At any time (no schedule defined).
🚦 Automerge: Disabled by config. Please merge this manually once you are satisfied.
♻ Rebasing: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.
🔕 Ignore: Close this PR and you won't be reminded about this update again.
This PR has been generated by Mend Renovate. View repository job log here.