From aa8f73f7e7c96478de93ad8b8eb1279fe25dd08c Mon Sep 17 00:00:00 2001
From: Jill R <4121322+jillr@users.noreply.github.com>
Date: Fri, 19 Jun 2020 12:17:54 -0700
Subject: [PATCH] Update note about AWS collection test requirements in docs
(#70176) (#70179)
(cherry picked from commit 8ad46870a4dabeec7df9cf554e46a38ffb782ec7)
---
.../contributing_maintained_collections.rst | 14 ++++++++------
1 file changed, 8 insertions(+), 6 deletions(-)
diff --git a/docs/docsite/rst/community/contributing_maintained_collections.rst b/docs/docsite/rst/community/contributing_maintained_collections.rst
index 835cc82c76e..93b5b64d8e9 100644
--- a/docs/docsite/rst/community/contributing_maintained_collections.rst
+++ b/docs/docsite/rst/community/contributing_maintained_collections.rst
@@ -67,15 +67,15 @@ The following table shows:
amazon.aws |
community.aws |
Cloud |
- ✓ |
- ✓ |
+ ✓** |
+ ** |
✓ |
Shippable |
✓ |
AWS guide |
- ansible.netcommon** |
+ ansible.netcommon*** |
community.network |
Network |
✓ |
@@ -101,7 +101,7 @@ The following table shows:
community.windows |
Windows |
✓ |
- ✓*** |
+ ✓**** |
✓ |
Shippable |
✓ |
@@ -224,9 +224,11 @@ The following table shows:
\* A ✓ under **Open to PRs** means the collection welcomes GitHub issues and PRs for any changes to existing collection content (plugins, roles, and so on).
- \*\* ``ansible.netcommon`` contains all foundational components for enabling many network and security :ref:`platform ` collections. It contains all connection and filter plugins required, and installs as a dependency when you install the the platform collection.
+ \*\* Integration tests are required and unit tests are welcomed but not required for the AWS collections. An exception to this is made in cases where integration tests are logistically not feasible due to external requirements. An example of this is AWS Direct Connect, as this service can not be functionally tested without the establishment of network peering connections. Unit tests are therefore required for modules that interact with AWS Direct Connect. Exceptions to ``amazon.aws`` must be approved by Red Hat, and exceptions to ``community.aws`` must be approved by the AWS community.
+
+ \*\*\* ``ansible.netcommon`` contains all foundational components for enabling many network and security :ref:`platform ` collections. It contains all connection and filter plugins required, and installs as a dependency when you install the the platform collection.
- \*\*\* Unit tests for Windows PowerShell modules are an exception to testing, but unit tests are valid and required for the remainder of the collection, including Ansible-side plugins.
+ \*\*\*\* Unit tests for Windows PowerShell modules are an exception to testing, but unit tests are valid and required for the remainder of the collection, including Ansible-side plugins.
.. _which_collection: