Add param ordering note to plugins page.

[agowa]

Add a note to every filter, test, and lookup to list positional parameters before keyword ones.

Relates to reviewer note ansible/ansible#80078 (comment) within ansible/ansible#80078

[felixfontein]

Thanks for your contribution. Please add a changelog fragment. Thanks.

[agowa]

I've included your suggestions and also added a changelog.
Btw, the link you provided maybe also needs an update. It says that documentation changes (which I'd consider this to be) are trivial and that trivial doesn't require a changelog fragment ;-)

[felixfontein]

I've included your suggestions and also added a changelog. Btw, the link you provided maybe also needs an update. It says that documentation changes (which I'd consider this to be) are trivial and that trivial doesn't require a changelog fragment ;-)

You are not changing documentation, but templates (and these are code).

[felixfontein]

Do you want to make some more updates? I can also push some updates if you don't have time.

There will be a new release of antsibull-docs in a couple of days, it would be nice if this PR can also make it in there.

[felixfontein]

Changes done by this PR:

1. Remove period at end of introductionary sentence for 'Positional parameters' and 'Keyword parameters':
   Compare https://ansible.fontein.de/collections/ansible/builtin/combine_filter.html#positional-parameters to https://docs.ansible.com/ansible/devel/collections/ansible/builtin/combine_filter.html#positional-parameters

2. Add a note for lookups, filters, and tests which both have terms (lookups) resp. positional parameters (filters, tests) together with keyword parameters (all of them)
   See https://ansible.fontein.de/collections/ansible/builtin/combine_filter.html#notes

3. Rename 'Parameters' for lookups to 'Keyword parameters' and add example what these are.
   Compare https://ansible.fontein.de/collections/community/sops/sops_lookup.html#keyword-parameters to https://docs.ansible.com/ansible/devel/collections/community/sops/sops_lookup.html#parameters

[samccann]

I don't have the opportunity at the moment to test this locally but based on the before/after links.. LGTM

[felixfontein]

@agowa338 thanks for improving the docs!
@samccann thanks for reviewing this!

[felixfontein]

This is now live on the Ansible devel docsite btw: https://docs.ansible.com/ansible/devel/collections/ansible/builtin/combine_filter.html#notes