chore(fmt): rename and alias params config varaint for clarity

[0xrusowsky]

Motivation

the naming for the the multiline_func_header config variant "params_first" is counter intuitive, as it is not aligned with the behavior of "params_first_multi".

see how it created confusion for users, who opened this issue:

• bug(fmt): multiline_func_header = "params_first" seems to always break the params #11933

Solution

because of that, i renamed the config variant to "params_always" to better reflect that this styling option will ALWAYS break the fn header params.

the old name "params_first" is kept as an alias for backwards compatibility

PR Checklist

• Added Tests
• Added Documentation
• Breaking changes

[grandizzy]

makes sense, let's update README too https://github.com/foundry-rs/foundry/tree/master/crates/fmt#configuration and dupe the test for params_first too to make sure alias does not get removed / introduce breaking change

[0xrusowsky]

makes sense, let's update README too master/crates/fmt#configuration and dupe the test for params_first too to make sure alias does not get removed / introduce breaking change

i tested both locally to make sure. do we still want to duplicate the whole file just for that?

completely forgot about the readme, thanks for the reminder 🤝

[grandizzy]

makes sense, let's update README too master/crates/fmt#configuration and dupe the test for params_first too to make sure alias does not get removed / introduce breaking change

i tested both locally to make sure. do we still want to duplicate the whole file just for that?

oh, not the whole file, but maybe just a test with inline config to make sure we don't remove the alias in future without ack the breaking change

[grandizzy]

lgtm