Update API docs and fix linting issues (#268)

* Fix document linting errors
* Add documentation for cm_prepare_db module
* Add futures for Python and encoding

Signed-off-by: Webster Mudge <[email protected]>

Author: wmudge

plugins/filter/version.yml

@@ -57,7 +57,7 @@ RETURN:
       - A dictionary of the version parts.
       - If unable to parse the string, returns C(None).
     type: dict
-    options:
+    contains:
       major:
         description: Major version
       minor:

plugins/modules/cm_prepare_db.py

@@ -15,7 +15,79 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-from __future__ import annotations
+from __future__ import absolute_import, division, print_function
+
+__metaclass__ = type
+
+DOCUMENTATION = r"""
+module: cm_prepare_db
+short_description: Configure the external Cloudera Manager server database
+description:
+  - Configure the external Cloudera Manager server database.
+author:
+  - "Webster Mudge (@wmudge)"
+version_added: "3.0.0"
+options:
+  config:
+    description:
+      - The database properties configuration file.
+    type: path
+    required: false
+    default: "/etc/cloudera-scm-server/db.properties"
+  script:
+    description:
+      - The script to execute.
+    type: path
+    required: true
+  type:
+    description:
+      - The database type to install.
+    type: str
+    required: true
+    choices:
+      - postgresql
+      - oracle
+      - mysql
+  host:
+    description:
+      - The database server host.
+    type: str
+    required: true
+  port:
+    description:
+      - The database server port.
+    type: int
+    required: true
+  database:
+    description:
+      - The name of the database.
+    type: str
+    required: true
+  username:
+    description:
+      - The username to access the database server.
+    type: str
+    required: true
+  password:
+    description:
+      - The password to access the database server.
+    type: str
+    required: true
+"""
+
+EXAMPLES = r"""
+- name: Prepare Cloudera Manager server external database
+  cloudera.exe.cm_prepare_db:
+    script: /opt/scm_prepare_database.sh
+    type: postreqsql
+    host: db.example.internal
+    port: 7717
+    database: cms
+    username: cms_db_user
+    password: SuperSecretPassword
+"""
+
+RETURN = r""""""
 
 import configparser
 

plugins/modules/deprecation.py

@@ -15,6 +15,10 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+from __future__ import absolute_import, division, print_function
+
+__metaclass__ = type
+
 DOCUMENTATION = r"""
 module: deprecation
 short_description: Display a deprecation warning

plugins/modules/jdk_facts.py

@@ -1,4 +1,5 @@
 #!/usr/bin/python
+# -*- coding: utf-8 -*-
 
 # Copyright 2024 Cloudera, Inc.
 #
@@ -23,7 +24,7 @@
 short_description: Retrieve JDK information
 description:
   - Retrieve information about the installed Java JDK as facts.
-version_added: 3.0.0
+version_added: "3.0.0"
 author:
   - Webster Mudge <[email protected]>
 extends_documentation_fragment:

roles/prereq_database/meta/argument_specs.yml

@@ -64,6 +64,6 @@ argument_specs:
             type: str
             required: true
           owner:
-            description: The name of the database user owning the database. Defaults to O(database_accounts.user).
+            description: The name of the database user owning the database. Defaults to O(database_accounts[].user).
             type: str
             required: false