updates to ansible-maintained collections guidelines (#70178)

docs/docsite/rst/community/contributing_maintained_collections.rst

@@ -120,7 +120,7 @@ The following table shows:
     </tr>
     <tr>
       <td><a href="https://galaxy.ansible.com/cisco/asa">cisco.asa</a></td>
-      <td>community.asa</td>
+      <td><a href="https://github.com/ansible-collections/community.asa">community.asa</a></td>
       <td><a href="https://github.com/ansible/community/wiki/Security-Automation">Security</a></td>
       <td>✓</td>
       <td>✓</td>
@@ -164,7 +164,7 @@ The following table shows:
     </tr>
     <tr>
       <td><a href="https://galaxy.ansible.com/ibm/qradar">ibm.qradar</a></td>
-      <td>community.qradar</td>
+      <td><a href="https://github.com/ansible-collections/community.qradar">community.qradar</a></td>
       <td><a href="https://github.com/ansible/community/wiki/Security-Automation">Security</a></td>
       <td>✓</td>
       <td></td>
@@ -197,7 +197,7 @@ The following table shows:
     </tr>
     <tr>
       <td><a href="https://github.com/ansible-collections/splunk.es">splunk.es</a></td>
-      <td>community.es</td>
+      <td><a href="https://github.com/ansible-collections/community.es">community.es</a></td>
       <td><a href="https://github.com/ansible/community/wiki/Security-Automation">Security</a></td>
       <td>✓</td>
       <td></td>
@@ -250,7 +250,7 @@ The following scenarios use the ``arista.eos`` to help explain when to contribut
     * Propose a new module in the ``community.network`` collection (requires network community approval).
     * Place your new module in a collection in your own namespace (no approvals required).
 
-  
+
 Most new content should go into either a related community collection or your own collection first so that is well established in the community before you can propose adding it to the  ``arista`` namespace, where inclusion and maintenance criteria are much higher.
 
 

docs/docsite/rst/network/dev_guide/developing_resource_modules_network.rst

@@ -511,9 +511,9 @@ For platforms that support ``connection: local`` *and* ``connection: network_cli
 * Name the :file:`targets/` directories after the module name.
 * The :file:`main.yaml` file should just reference the transport.
 
-The following example walks through the integration tests for the ``vyos.vyos.vyos_banner`` module in the `vyos.vyos <https://github.com/ansible-collections/vyos.vyos/tree/master/tests/integration>`_ collection:
+The following example walks through the integration tests for the ``vyos.vyos.vyos_l3_interfaces`` module in the `vyos.vyos <https://github.com/ansible-collections/vyos.vyos/tree/master/tests/integration>`_ collection:
 
-``test/integration/targets/vyos_banner/tasks/main.yaml``
+``test/integration/targets/vyos_l3_interfaces/tasks/main.yaml``
 
 .. code-block:: yaml
 
@@ -522,7 +522,7 @@ The following example walks through the integration tests for the ``vyos.vyos.vy
      tags:
        - cli
 
-``test/integration/targets/vyos_banner/tasks/cli.yaml``
+``test/integration/targets/vyos_l3_interfaces/tasks/cli.yaml``
 
 .. code-block:: yaml
 
@@ -549,46 +549,71 @@ The following example walks through the integration tests for the ``vyos.vyos.vy
      loop_control:
        loop_var: test_case_to_run
 
-``test/integration/targets/vyos_banner/tests/cli/basic-no-login.yaml``
+``test/integration/targets/vyos_l3_interfaces/tests/cli/overridden.yaml``
 
 .. code-block:: yaml
 
-   ---
+  ---
-   - debug:
+  - debug:
-       msg: "cli/basic-no-login.yaml on connection={{ ansible_connection }}"
+   msg: START vyos_l3_interfaces merged integration tests on connection={{ ansible_connection
-
+     }}
-   - name: Setup
+
-     vyos_banner:
+  - include_tasks: _remove_config.yaml
-       banner: pre-login
+
-       text: |
+  - block:
-         Junk pre-login banner
+
-         over multiple lines
+   - include_tasks: _populate.yaml
-       state: present
+
-
+   - name: Overrides all device configuration with provided configuration
-   - name: remove pre-login
-     vyos_banner:
-       banner: pre-login
-       state: absent
      register: result
+     vyos.vyos.vyos_l3_interfaces: &id001
+       config:
+
+         - name: eth0
+           ipv4:
+
+             - address: dhcp
 
-   - debug:
+         - name: eth1
-       msg: "{{ result }}"
+           ipv4:
 
-   - assert:
+             - address: 192.0.2.15/24
+       state: overridden
+
+   - name: Assert that before dicts were correctly generated
+     assert:
+       that:
+         - "{{ populate | symmetric_difference(result['before']) |length == 0 }}"
+
+   - name: Assert that correct commands were generated
+     assert:
+       that:
+         - "{{ overridden['commands'] | symmetric_difference(result['commands'])\
+           \ |length == 0 }}"
+
+   - name: Assert that after dicts were correctly generated
+     assert:
        that:
-         - "result.changed == true"
+         - "{{ overridden['after'] | symmetric_difference(result['after']) |length\
-         - "'delete system login banner pre-login' in result.commands"
+           \ == 0 }}"
 
-   - name: remove pre-login (idempotent)
+   - name: Overrides all device configuration with provided configurations (IDEMPOTENT)
-     vyos_banner:
-       banner: pre-login
-       state: absent
      register: result
+     vyos.vyos.vyos_l3_interfaces: *id001
+
+   - name: Assert that the previous task was idempotent
+     assert:
+       that:
+         - result['changed'] == false
 
-   - assert:
+   - name: Assert that before dicts were correctly generated
+     assert:
        that:
-         - "result.changed == false"
+         - "{{ overridden['after'] | symmetric_difference(result['before']) |length\
-         - "result.commands | length == 0"
+           \ == 0 }}"
+  always:
+
+   - include_tasks: _remove_config.yaml
 
 
 Detecting test resources at runtime
@@ -659,14 +684,14 @@ To run integration tests for a specific module:
 
 .. code-block:: bash
 
-  ansible-test network-integration --inventory  /path/to-collection-module/test/integration/inventory.networking vyos_vlan
+  ansible-test network-integration --inventory  /path/to-collection-module/test/integration/inventory.networking vyos_l3_interfaces
 
 To run a single test case on a specific module:
 
 .. code-block:: bash
 
-   # Only run vyos_vlan/tests/cli/basic.yaml
+   # Only run vyos_l3_interfaces/tests/cli/gathered.yaml
-   ansible-test network-integration --inventory  /path/to-collection-module/test/integration/inventory.networking vyos_vlan --testcase basic
+   ansible-test network-integration --inventory  /path/to-collection-module/test/integration/inventory.networking vyos_l3_interfaces --testcase gathered
 
 To run integration tests for a specific transport: