Merge pull request #58 from vera-chan/review-comments

take demetri's changes

Author: stewartfrancis

docs/ansible_content.rst

@@ -2,21 +2,29 @@
 .. © Copyright IBM Corporation 2020                                          .
 .. ...........................................................................
 
-CICS Collection
-========================
+=========
+z/OS CICS
+=========
 
-The **IBM® z/OS® CICS® collection**, also represented as **ibm\_zos\_cics**
-in this document, is part of the broader initiative to bring Ansible® Automation to IBM Z® through the offering Red Hat® Ansible Certified Content for IBM Z®. It provides tasks to define, install, and perform actions on CICS definitions and resources such as creating a PROGRAM definition, installing and updating it, and deleting the definition.
+The **IBM® z/OS® CICS® collection**, also represented as
+ibm_zos_cics in this document, is  part of the broader
+initiative to bring Ansible® Automation to IBM Z® through the offering
+**Red Hat® Ansible Certified Content for IBM Z**.
 
-The CICS collection can work in conjunction with or independently from other IBM z/OS collections on Ansible such as the `IBM z/OS core collection`_. When used alone, it performs automation tasks solely in CICS. When using it together with other z/OS collections, you can achieve a more powerful solution for automating tasks on z/OS.
+The **IBM® z/OS® CICS® collection** supports automation tasks that can
+define, install, and perform actions on CICS definitions and resources such as
+creating a PROGRAM definition, installing and updating it, and deleting the
+definition.
 
+The Ansible modules in this collection are written in Python and interact with
+the `CMCI REST API`_ of the CICS® management client interface (CMCI) for system
+management.
 
-.. _IBM z/OS core collection:
-   https://github.com/ansible-collections/ibm_zos_core
-
+.. _CMCI REST API:
+   https://www.ibm.com/support/knowledgecenter/SSGMCP_5.6.0/fundamentals/cpsm/cpsm-cmci-restfulapi-overview.html
 
 .. toctree::
    :maxdepth: 1
-   :caption: Reference
+   :caption: Collection Content
 
    source/modules

docs/source/community_guides.rst

@@ -3,6 +3,7 @@
 .. Apache License, Version 2.0 (see https://opensource.org/licenses/Apache-2.0)  .
 .. ...............................................................................
 
+============
 Contributing
 ============
 

docs/source/index.rst

@@ -41,19 +41,6 @@ The IBM z/OS CICS collection includes `modules`_, `sample playbooks`_, and ansib
 .. _sample playbooks:
     https://github.com/ansible-collections/ibm_zos_cics/tree/master/playbooks/
 
-Contributing
-============
-
-Thank you for contributing to this project.
-
-We welcome bug reports and discussions about new function in the issue tracker, and we also welcome proposed new features or bug fixes via pull requests.
-
-For contribution guidelines, see `How to contribute`_.
-
-.. _How to contribute:
-   https://github.com/ansible-collections/ibm_zos_cics/tree/master/CONTRIBUTING.md
-
-
 
 Copyright
 =========

docs/source/modules.rst

@@ -6,15 +6,15 @@
 Modules
 =======
 
-Modules can be used in a playbook to automate tasks. Ansible® executes each module on the target node and returns the result back to the controller.
+Modules can be used in a playbook to automate tasks. Ansible® executes each
+module on the target node and returns the result back to the controller.
 
-The **IBM® z/OS® CICS® collection** contains these modules. For each module, the accepted parameters, return values, and examples are provided in the documentation.
+The **IBM® z/OS® CICS® collection** contains these modules. For each module,
+the accepted parameters, return values, and examples are provided in the
+documentation.
 
 .. toctree::
    :maxdepth: 1
    :glob:
 
    modules/*
-
-
-

docs/source/requirements.rst

@@ -32,7 +32,7 @@ A control node is any machine with Ansible® installed. You can run commands and
 Managed node
 ------------
 
-The CMCI tasks in the IBM z/OS CICS collection interact with the managed node over an HTTP connection by leveraging the `CMCI REST API`_. Therefore, an SSH connection is not necessary. Instead, you can delegate the CMCI tasks to run on the control node directly, for example, by specifying ``delegate_to: 'localhost'`` for the tasks in the playbook. For detailed requirements, see :doc:`requirements_managed`.
+For detailed requirements, see :doc:`requirements_managed`.
 
 
 .. toctree::

docs/source/requirements_managed.rst

@@ -5,9 +5,13 @@
 Requirements of managed nodes
 =============================
 
-The CMCI tasks in the **IBM® z/OS® CICS® collection** interact with the managed node over an HTTP connection by leveraging the `CMCI REST API`_. Therefore, an SSH connection is not necessary. Instead, you can delegate Ansible tasks to run on the control node, for example, by specifying ``delegate_to: 'localhost'`` for the task in the playbook. For more ways of delegating tasks, see `Controlling where tasks run`_.
-
-Delegating tasks to run on the control node saves you the complexity of configuring an unnecessary SSH connection and installing module dependencies on the remote host.
+The CMCI tasks in the **IBM® z/OS® CICS® collection** interact
+with the managed node over an HTTP connection by leveraging the `CMCI REST API`_.
+Therefore, an SSH connection is not required. Instead, you can delegate
+Ansible tasks to run on the control node, for example, by specifying
+``delegate_to: 'localhost'`` for the task in the playbook. In this case, you
+install dependencies on your localhost instead of the managed node.
+For more ways of delegating tasks, see `Controlling where tasks run`_.
 
 The requirements of the managed node are as follows:
 
@@ -18,7 +22,8 @@ The requirements of the managed node are as follows:
   * `requests`_
   * `xmltodict`_
 
-  If you delegate the tasks to run on your localhost, the Python module dependencies need to be installed on your localhost instead. You can install them from CLI:
+  If you delegate the tasks to run on your localhost, the Python module dependencies
+  need to be installed on your localhost instead. You can install them from CLI:
 
   .. code-block:: sh