Fix invalid fields in module DOCUMENATION (#22297)

* fix module doc fields

* More module docs corrections

* More module docs corrections

* More module docs corrections

* More module docs corrections

* correct aliases

* Review comments

* Must quote ':'

* More authors

* Use suboptions:

* restore type: bool

* type should be in the same place

* More tidyups

* authors

* Use suboptions

* revert

* remove duplicate author

* More issues post rebase

lib/ansible/modules/system/aix_inittab.py

@@ -35,12 +35,10 @@ options:
   name:
     description: Name of the inittab entry.
     required: True
-    alias: service
-    type: string
+    aliases: ['service']
   runlevel:
     description: Runlevel of the entry.
     required: True
-    type: string
   action:
     description: Action what the init has to do with this entry.
     required: True
@@ -58,22 +56,17 @@ options:
                'initdefault',
                'sysinit'
               ]
-    type: string
   command:
     description: What command has to run.
     required: True
-    type: string
   insertafter:
     description: After which inittabline should the new entry inserted.
-    type: string
   state:
     description: Whether the entry should be present or absent in the inittab file
-    type: string
     choices: [ "present", "absent" ]
     default: present
 notes:
-  - The changes are persistent across reboots.
-  - You need root rights to read or adjust the inittab with the lsitab, chitab,
+  - The changes are persistent across reboots, you need root rights to read or adjust the inittab with the lsitab, chitab,
     mkitab or rmitab commands.
   - tested on AIX 7.1.
 requirements: [ 'itertools']

lib/ansible/modules/system/beadm.py

@@ -36,7 +36,7 @@ options:
     name:
         description:
             - ZFS boot environment name.
-        alias: [ "be" ]
+        aliases: [ "be" ]
         required: True
     snapshot:
         description:

lib/ansible/modules/system/pam_limits.py

@@ -26,7 +26,7 @@ DOCUMENTATION = '''
 ---
 module: pam_limits
 version_added: "2.0"
-authors:
+author:
     - "Sebastien Rohaut (@usawa)"
 short_description: Modify Linux PAM limits
 description:

lib/ansible/modules/system/ufw.py

@@ -53,7 +53,7 @@ options:
     description:
       - Change the default policy for incoming or outgoing traffic.
     required: false
-    alias: default
+    aliases: ['default']
     choices: ['allow', 'deny', 'reject']
   direction:
     description: