Aliases

[304NotModified]

@snakefoot I think it's important to make the aliases visible and searchable on https://nlog-project.org/config.

1. What do you think about this design?

• Added aliases to the end
• Added prefix "package" for the packages

2. What should be do with NLog 4 and NLog 5? Do I need to copy the page and jsons for NLog 5?

[304NotModified]

related NLog/NLog#4716

[304NotModified]

Preview: https://304notmodified.github.io/config/

[snakefoot]

1. What do you think about this design?

Think it is nice with tags/keywords, just like one have for normal nuget-packages. But still think the actual alias-symbol-names should primarily be documented on the individual wiki-pages. Btw. Could my pull-request #183 about cleaning up platforms be merged first?

[snakefoot]

2. What should be do with NLog 4 and NLog 5? Do I need to copy the page and jsons for NLog 5?

Nothing has been removed with NLog 5, so the wiki-pages remains the same. There might be a new nuget-package, but I think people will recognize from the NLog-version-number whether it is relevant for NLog4 or NLog5.

For me it is okay to only maintain a single NLog-config-page (since it matches the wiki-pages).

[304NotModified]

Im afraid that people get confused with the changes between nlog 4 and 5.

We need at least someting to the docs for that. And im thinking of adding a note to https://nlog-project.org/config/

I consider this as a showstopper :(

[304NotModified]

The aliases are new for nlog 5.

But im aware of the large user base of nlog 4

[snakefoot]

Im afraid that people get confused with the changes between nlog 4 and 5.

That is usually how the wiki-pages works. When adding details about new features, then one also specify what version of NLog is required.

[snakefoot]

Since the alias-feature seems to be very difficult to explain and understand, and it is blocking the NLog 5.0 release (Cannot get my pull-requests merged for NLog5-docs), then I'm fine with either option:

• Have it as an exotic feature that is not documented, that NLog-config-parser can be forgiving sometimes.
• Merge the alias-feature to the NLog4-master-branch, since it is not a breaking change.
• Remove the alias-feature from the NLog5-dev-branch.

[304NotModified]

I just added (NLog 5 only) to the tooltip in #187