Doc notes 5 (#64928)

* addd

* all  update

* add/update notes.

* add/updates notes.

* new version 2.10 can not be backported

lib/ansible/modules/network/cloudengine/ce_netstream_global.py

@@ -27,6 +27,9 @@ short_description: Manages global parameters of NetStream on HUAWEI CloudEngine
 description:
     - Manages global parameters of NetStream on HUAWEI CloudEngine switches.
 author: YangYang (@QijunPan)
+notes:
+    - Recommended connection is C(network_cli).
+    - This module also works with C(local) connections for legacy playbooks.
 options:
     type:
         description:

lib/ansible/modules/network/cloudengine/ce_netstream_template.py

@@ -29,6 +29,9 @@ description:
     - Manages NetStream template configuration on HUAWEI CloudEngine switches.
 author:
     - wangdezhuang (@QijunPan)
+notes:
+    - Recommended connection is C(network_cli).
+    - This module also works with C(local) connections for legacy playbooks.
 options:
     state:
         description:

lib/ansible/modules/network/cloudengine/ce_ntp.py

@@ -29,6 +29,10 @@ description:
     - Manages core NTP configuration on HUAWEI CloudEngine switches.
 author:
     - Zhijin Zhou (@QijunPan)
+notes:
+    - This module requires the netconf system service be enabled on the remote device being managed.
+    - Recommended connection is C(netconf).
+    - This module also works with C(local) connections for legacy playbooks.
 options:
     server:
         description:

lib/ansible/modules/network/cloudengine/ce_ntp_auth.py

@@ -35,6 +35,8 @@ notes:
       If a matching key configuration isn't found on the device, the module will fail.
     - If C(state=absent) and C(authentication=on), authentication will be turned on.
     - If C(state=absent) and C(authentication=off), authentication will be turned off.
+    - Recommended connection is C(network_cli).
+    - This module also works with C(local) connections for legacy playbooks.
 options:
     key_id:
         description:

lib/ansible/modules/network/cloudengine/ce_ospf.py

@@ -28,6 +28,10 @@ short_description: Manages configuration of an OSPF instance on HUAWEI CloudEngi
 description:
     - Manages configuration of an OSPF instance on HUAWEI CloudEngine switches.
 author: QijunPan (@QijunPan)
+notes:
+    - This module requires the netconf system service be enabled on the remote device being managed.
+    - Recommended connection is C(netconf).
+    - This module also works with C(local) connections for legacy playbooks.
 options:
     process_id:
         description:

lib/ansible/modules/network/cloudengine/ce_ospf_vrf.py

@@ -28,6 +28,10 @@ short_description: Manages configuration of an OSPF VPN instance on HUAWEI Cloud
 description:
     - Manages configuration of an OSPF VPN instance on HUAWEI CloudEngine switches.
 author: Yang yang (@QijunPan)
+notes:
+    - This module requires the netconf system service be enabled on the remote device being managed.
+    - Recommended connection is C(netconf).
+    - This module also works with C(local) connections for legacy playbooks.
 options:
     ospf:
         description:

lib/ansible/modules/network/cloudengine/ce_reboot.py

@@ -28,6 +28,10 @@ short_description: Reboot a HUAWEI CloudEngine switches.
 description:
     - Reboot a HUAWEI CloudEngine switches.
 author: Gong Jianjun (@QijunPan)
+notes:
+    - This module requires the netconf system service be enabled on the remote device being managed.
+    - Recommended connection is C(netconf).
+    - This module also works with C(local) connections for legacy playbooks.
 requirements: ["ncclient"]
 options:
     confirm:

lib/ansible/modules/network/cloudengine/ce_rollback.py

@@ -29,6 +29,9 @@ description:
       file or rollback to a configuration checkpoint file on HUAWEI CloudEngine switches.
 author:
     - Li Yanfeng (@QijunPan)
+notes:
+    - Recommended connection is C(network_cli).
+    - This module also works with C(local) connections for legacy playbooks.
 options:
     commit_id:
         description:

lib/ansible/modules/network/cloudengine/ce_sflow.py

@@ -30,6 +30,10 @@ description:
       detect abnormal traffic, and locate the source of attack traffic,
       ensuring stable running of the network.
 author: QijunPan (@QijunPan)
+notes:
+    - This module requires the netconf system service be enabled on the remote device being managed.
+    - Recommended connection is C(netconf).
+    - This module also works with C(local) connections for legacy playbooks.
 options:
     agent_ip:
         description:

lib/ansible/modules/network/cloudengine/ce_snmp_community.py

@@ -29,6 +29,10 @@ description:
     - Manages SNMP community configuration on HUAWEI CloudEngine switches.
 author:
     - wangdezhuang (@QijunPan)
+notes:
+    - This module requires the netconf system service be enabled on the remote device being managed.
+    - Recommended connection is C(netconf).
+    - This module also works with C(local) connections for legacy playbooks.
 options:
     acl_number:
         description:

lib/ansible/modules/network/cloudengine/ce_snmp_contact.py

@@ -29,6 +29,9 @@ description:
     - Manages SNMP contact configurations on HUAWEI CloudEngine switches.
 author:
     - wangdezhuang (@QijunPan)
+notes:
+    - Recommended connection is C(network_cli).
+    - This module also works with C(local) connections for legacy playbooks.
 options:
     contact:
         description:

lib/ansible/modules/network/cloudengine/ce_snmp_location.py

@@ -29,6 +29,9 @@ description:
     - Manages SNMP location configurations on HUAWEI CloudEngine switches.
 author:
     - wangdezhuang (@QijunPan)
+notes:
+    - Recommended connection is C(network_cli).
+    - This module also works with C(local) connections for legacy playbooks.
 options:
     location:
         description:

lib/ansible/modules/network/cloudengine/ce_snmp_target_host.py

@@ -29,6 +29,10 @@ description:
     - Manages SNMP target host configurations on HUAWEI CloudEngine switches.
 author:
     - wangdezhuang (@QijunPan)
+notes:
+    - This module requires the netconf system service be enabled on the remote device being managed.
+    - Recommended connection is C(netconf).
+    - This module also works with C(local) connections for legacy playbooks.
 options:
     version:
         description:

lib/ansible/modules/network/cloudengine/ce_snmp_traps.py

@@ -29,6 +29,9 @@ description:
     - Manages SNMP traps configurations on HUAWEI CloudEngine switches.
 author:
     - wangdezhuang (@QijunPan)
+notes:
+    - Recommended connection is C(network_cli).
+    - This module also works with C(local) connections for legacy playbooks.
 options:
     feature_name:
         description:

lib/ansible/modules/network/cloudengine/ce_snmp_user.py

@@ -29,6 +29,10 @@ description:
     - Manages SNMP user configurations on CloudEngine switches.
 author:
     - wangdezhuang (@QijunPan)
+notes:
+    - This module requires the netconf system service be enabled on the remote device being managed.
+    - Recommended connection is C(netconf).
+    - This module also works with C(local) connections for legacy playbooks.
 options:
     acl_number:
         description:

lib/ansible/modules/network/cloudengine/ce_startup.py

@@ -29,6 +29,9 @@ description:
     - Manages a system startup information on HUAWEI CloudEngine switches.
 author:
     - Li Yanfeng (@QijunPan)
+notes:
+    - Recommended connection is C(network_cli).
+    - This module also works with C(local) connections for legacy playbooks.
 options:
     cfg_file:
         description:

lib/ansible/modules/network/cloudengine/ce_static_route.py

@@ -16,8 +16,10 @@ description:
 author: Yang yang (@QijunPan)
 notes:
     - If no vrf is supplied, vrf is set to default.
-      If I(state=absent), the route will be removed, regardless of the
+    - If I(state=absent), the route will be removed, regardless of the non-required parameters.
-      non-required parameters.
+    - This module requires the netconf system service be enabled on the remote device being managed.
+    - Recommended connection is C(netconf).
+    - This module also works with C(local) connections for legacy playbooks.
 options:
     prefix:
         description:

lib/ansible/modules/network/cloudengine/ce_stp.py

@@ -29,6 +29,9 @@ description:
     - Manages STP configurations on HUAWEI CloudEngine switches.
 author:
     - wangdezhuang (@QijunPan)
+notes:
+    - Recommended connection is C(network_cli).
+    - This module also works with C(local) connections for legacy playbooks.
 options:
     state:
         description:

lib/ansible/modules/network/cloudengine/ce_switchport.py

@@ -30,13 +30,13 @@ description:
 author: QijunPan (@QijunPan)
 notes:
     - When C(state=absent), VLANs can be added/removed from trunk links and
-      the existing access VLAN can be 'unconfigured' to just having VLAN 1
+      the existing access VLAN can be 'unconfigured' to just having VLAN 1 on that interface.
-      on that interface.
     - When working with trunks VLANs the keywords add/remove are always sent
-      in the C(port trunk allow-pass vlan) command. Use verbose mode to see
+      in the C(port trunk allow-pass vlan) command. Use verbose mode to see commands sent.
-      commands sent.
+    - When C(state=unconfigured), the interface will result with having a default Layer 2 interface, i.e. vlan 1 in access mode.
-    - When C(state=unconfigured), the interface will result with having a default
+    - This module requires the netconf system service be enabled on the remote device being managed.
-      Layer 2 interface, i.e. vlan 1 in access mode.
+    - Recommended connection is C(netconf).
+    - This module also works with C(local) connections for legacy playbooks.
 options:
     interface:
         description: