modify azure_rm_aks* document (#56293)

lib/ansible/modules/cloud/azure/azure_rm_aks.py

@@ -16,9 +16,9 @@ DOCUMENTATION = '''
 ---
 module: azure_rm_aks
 version_added: "2.6"
-short_description: Manage a managed Azure Container Service (AKS) Instance.
+short_description: Manage a managed Azure Container Service (AKS) instance
 description:
-    - Create, update and delete a managed Azure Container Service (AKS) Instance.
+    - Create, update and delete a managed Azure Container Service (AKS) instance.
 
 options:
     resource_group:
@@ -47,11 +47,11 @@ options:
             - Version of Kubernetes specified when creating the managed cluster.
     linux_profile:
         description:
-            - The linux profile suboptions.
+            - The Linux profile suboptions.
         suboptions:
             admin_username:
                 description:
-                  - The Admin Username for the Cluster.
+                    - The Admin Username for the cluster.
                 required: true
             ssh_key:
                 description:
@@ -63,16 +63,16 @@ options:
         suboptions:
             name:
                 description:
-                  - Unique name of the agent pool profile in the context of the subscription and resource group.
+                    - Unique name of the agent pool profile in the context of the subscription and resource group.
                 required: true
             count:
                 description:
                     - Number of agents (VMs) to host docker containers.
-                    - Allowed values must be in the range of 1 to 100 (inclusive).
+                    - Allowed values must be in the range of C(1) to C(100) (inclusive).
                 required: true
             vm_size:
                 description:
-                    - The VM Size of each of the Agent Pool VM's (e.g. Standard_F1 / Standard_D2v2).
+                    - The VM Size of each of the Agent Pool VM's (e.g. C(Standard_F1) / C(Standard_D2v2)).
                 required: true
             os_disk_size_gb:
                 description:
@@ -95,7 +95,7 @@ options:
             - Existing non-RBAC enabled AKS clusters cannot currently be updated for RBAC use.
         type: bool
         default: no
-        version_added: 2.8
+        version_added: "2.8"
     network_profile:
         description:
             - Profile of network configuration.
@@ -107,30 +107,38 @@ options:
                     - With C(kubenet), nodes get an IP address from the Azure virtual network subnet.
                     - AKS features such as Virtual Nodes or network policies aren't supported with C(kubenet).
                     - C(azure) enables Azure Container Networking Interface(CNI), every pod gets an IP address from the subnet and can be accessed directly.
+                default: kubenet
                 choices:
                     - azure
                     - kubenet
             network_policy:
                 description: Network policy used for building Kubernetes network.
+                choices:
+                    - azure
+                    - calico
             pod_cidr:
                 description:
-                    - A CIDR notation IP range from which to assign pod IPs when kubenet is used.
+                    - A CIDR notation IP range from which to assign pod IPs when I(network_plugin=kubenet) is used.
                     - It should be a large address space that isn't in use elsewhere in your network environment.
                     - This address range must be large enough to accommodate the number of nodes that you expect to scale up to.
+                default: "10.244.0.0/16"
             service_cidr:
                 description:
                     - A CIDR notation IP range from which to assign service cluster IPs.
                     - It must not overlap with any Subnet IP ranges.
                     - It should be the *.10 address of your service IP address range.
+                default: "10.0.0.0/16"
             dns_service_ip:
                 description:
                     - An IP address assigned to the Kubernetes DNS service.
                     - It must be within the Kubernetes service address range specified in serviceCidr.
+                default: "10.0.0.10"
             docker_bridge_cidr:
                 description:
                     - A CIDR notation IP range assigned to the Docker bridge network.
                     - It must not overlap with any Subnet IP ranges or the Kubernetes service address range.
-        version_added: 2.8
+                default: "172.17.0.1/16"
+        version_added: "2.8"
     aad_profile:
         description:
             - Profile of Azure Active Directory configuration.
@@ -145,7 +153,7 @@ options:
                 description:
                     - The AAD tenant ID to use for authentication.
                     - If not specified, will use the tenant of the deployment subscription.
-        version_added: 2.8
+        version_added: "2.8"
     addon:
         description:
             - Profile of managed cluster add-on.
@@ -188,7 +196,7 @@ options:
                     subnet_resource_id:
                         description:
                             - Subnet associdated to the cluster.
-        version_added: 2.8
+        version_added: "2.8"
 
 extends_documentation_fragment:
     - azure
@@ -228,7 +236,7 @@ EXAMPLES = '''
 '''
 RETURN = '''
 state:
-    description: Current state of the Azure Container Service (AKS)
+    description: Current state of the Azure Container Service (AKS).
     returned: always
     type: dict
     example:

lib/ansible/modules/cloud/azure/azure_rm_aks_facts.py

@@ -18,7 +18,7 @@ module: azure_rm_aks_facts
 
 version_added: "2.6"
 
-short_description: Get Azure Kubernetes Service facts.
+short_description: Get Azure Kubernetes Service facts
 
 description:
     - Get facts for a specific Azure Kubernetes Service or all Azure Kubernetes Services.
@@ -37,7 +37,7 @@ options:
         description:
             - Show kubeconfig of the AKS cluster.
             - Note the operation will cost more network overhead, not recommended when listing AKS.
-        version_added: 2.8
+        version_added: "2.8"
         choices:
             - user
             - admin

lib/ansible/modules/cloud/azure/azure_rm_aksversion_facts.py

@@ -18,7 +18,7 @@ module: azure_rm_aksversion_facts
 
 version_added: "2.8"
 
-short_description: Get available kubernetes versions supported by Azure Kubernetes Service.
+short_description: Get available kubernetes versions supported by Azure Kubernetes Service
 
 description:
     - Get available kubernetes versions supported by Azure Kubernetes Service.