ipauser: Fix documentation sections and agument spec

ipavault: Fix documentation sections and agument spec

ipadnsforwardzone: : Fix documentation sections and agument spec

ipatopologysegment: Fix documentation sections and agument spec

ansible-test with ansible-2.14 is adding a lot of new tests to ensure
that the documentation section and the agument spec is complete. Needed
changes:

DOCUMENTATION section

- `type: str` needs to be set for string parameters
- `author` needs to be given with the github user also: `Name (@user)`

argument_spec

- `type="str"` needs to added to all string parameters

The `copyright` date is extended with `-2022`.

According to the argument_spec new_public_key is an alias for
vault_public_key and new_public_key_file is an alias for
vault_public_key_file. The aliases have been added.

ansible-test with ansible-2.14 is adding a lot of new tests to ensure
that the documentation section and the agument spec is complete. Needed
changes:

DOCUMENTATION section

- `type: str` needs to be set for string parameters
- `type: bool` needs to be set for bool parameters

- `type: list` needs to be set for list parameters
- `elements: str` needs to be given for list of string parameters
- `type: string` is not valid and needs to be replaced by `type: str`
- `required` tags need to be fixed according to the `argument_spec`
- `aliases` tag needs to match `argument_spec`
- `author` needs to be given with the github user also: `Name (@user)`
- `choices` needs to match `argument_spec`
- all parameters need to be defined

RETURN section

- `contains` needs to be used instead of `options` for dicts
- `type: string` is not valid and needs to be replaced by `type: str`

argument_spec

- `elements="str"` needs to be added to all list of string parameters
- `default=.*` needs to be dropped if `required=True` is also given

The `copyright` date is extended with `-2022`.

documentation: Change occurences of whitelist to allowlist.

new_module: Modify new_module and templates for Ansible 2.14

This change follows language use recomendation from NISTIR 8366,
"Guidance for NIST Staff on Using Inclusive Language in Documentary
Standards", accessible from

    https://nvlpubs.nist.gov/nistpubs/ir/2021/NIST.IR.8366.pdf

ipaconfig: Do not require enable_sid for add_sids or netbios_name

Current behavior of ipaconfig mimics FreeIPA CLI and requires that
'enable_sid' is set to True every time add_sids or netbios_name are
used. It is sufficient that SID generation is enabled to use add_sids
and netbios_name, but the IPA API requires 'enable_sid' so that the
operations are executed.

This patch allows ansible-freeipa plugin ipaconfig to run 'add_sids' or
set 'netbios_name without requiring 'enable_sid' to be set on the
playbook.

If SID generation is enabled, 'add_sids' and 'netbios_name' can be used
without 'enable_sid: yes'. If SID generation is not enabled, an error
message will be raised if 'enable_sid: yes' is not used.

ipaconfig: Do not allow enable_sid set to False.

Once enabled, SID cannot be disabled. This patch ensures that an error
is raised if one tries to disable SID.

ipaconfig: Fix fail_json calls.

ipaservice:: Fix documentation sections and agument spec

ipaserver: Fix documentation sections and agument spec

iparole: Fix documentation sections and agument spec

ipaselfservice: Fix documentation sections and agument spec

ipaprivilege: Fix documentation sections and agument spec

ipapermission: Fix documentation sections and agument spec

ipaidrange: Fix documentation sections and agument spec

ansible-test with ansible-2.14 is adding a lot of new tests to ensure
that the documentation section and the agument spec is complete.

To aid the creation of new_modules that follow these rules, the
'new_module' script and its templates were modified to use the new
ansible-test rules. The 'new_module' script now requires a new
argument, github_user, and the code templates provide the required
fields (like 'type' and 'elements') to the provide examples.

ipapwpolicy: Fix documentation sections and agument spec

ipaservicedelegationrule: Fix documentation sections and agument spec

ipaservicedelegationtarget: Fix documentation sections and agument spec

ipasudocmd: Fix documentation sections and agument spec

ipatopologysuffix: Fix documentation sections and agument spec

ipasudocmdgroup: Fix documentation sections and agument spec

ipatrust Fix documentation sections and agument spec

ipahostgroup: Fix documentation sections and agument spec

ipahbacsvcgroup: Fix documentation sections and agument spec

ipahbacsvc: Fix documentation sections and agument spec

ipalocation: Fix documentation sections and agument spec

ipahbacrule: Fix documentation sections and agument spec

ipagroup: Fix documentation sections and agument spec

ipadnsconfig: Fix documentation sections and agument spec

ipadnszone: Fix documentation sections and agument spec

ipadelegation: : Fix documentation sections and agument spec

Ansible's fail_json() method required that the message paramater was
passed with a keyword parameter, rather than a positional one. Although
this seems to work with ansible-core 2.13+, it might not work with
previous versions of Ansible.

This patch fixes the behaviour for all supported Ansible versions.