Enhancement: Add migration proposal for deprecated plugin parameters/FISH-12160

[pzygielo]

Brief Summary

• Currently, with FISH-10877 Prefix params with 'payara' keyword in Payara Micro and Server plugin ecosystem-maven#444 the new plugin reports:

[INFO] --- payara-micro:2.5:start (...) @ war ---
[WARNING]  Parameter 'payaraVersion' (user property 'payaraVersion') is deprecated: No reason given

The https://docs.payara.fish/community/docs/Technical%20Documentation/Ecosystem/Project%20Management%20Tools/Maven%20Plugin.html

still uses payaraVersion

(NB as {page-version})

Expected Outcome

Something like

[WARNING]  Parameter 'payaraVersion' (user property 'payaraVersion') is deprecated: use XYZ instead

Current Outcome

[WARNING]  Parameter 'payaraVersion' (user property 'payaraVersion') is deprecated: No reason given

Alternatives

Read the plugin sources to find out replacement properties.

Context

No response

[pzygielo]

I see some attempt to consider this in plugin 2.5.1, but it does not work:

[INFO] --- payara-micro:2.5.1:start (XXX) @ YYY ---
[WARNING]  Parameter 'payaraVersion' (user property 'payaraVersion') is deprecated: No reason given
[INFO] No Jakarta EE dependency found. Using latest Payara Micro version: 7.2025.1.Alpha3
[INFO] Resolving fish.payara.extras:payara-micro:jar:7.2025.1.Alpha3
[INFO] Starting payara-micro from path: ...

so I can't see payara/ecosystem-maven@f59fba8#diff-24ac136c1716af62f28932bd8d553116cf5fac348ef6cd07468efe7e37043116R202

Also - I'd think that javadocing @deprecated would cause the original direct warning from maven ([WARNING] Parameter 'payaraVersion' (user property 'payaraVersion') is deprecated: No reason given) to include the reason already... IMO - much better than the series of (now not seen in action) getLog().warns...

[jGauravGupta]

Created internal ticket FISH-12160 to address the issue.

[felixif]

Hello @pzygielo, as Gaurav mentioned above, this has been escalated directly to him to address, and the enhancement request will be mentioned in the release notes as FISH-12160. Thank you very much for your contribution to make our tools more clear and accessible.