search

IBM / z_ansible_collections_doc

Repository for Z collections documentation
Apache License 2.0
8 stars 8 forks source link

Enhance the information about z/os core collection dependencies, maybe a table to outline the collections lifecycles #54

Open jennyhuang17 opened 8 months ago

jennyhuang17 commented 8 months ago

Description of the issue

Hi - I have a customer using python, ZOAU and Ansible on z/OS. They have commented that it is becoming increasingly difficult to make sure that the three products are all at the right version for each other. They have said that it is ZOAU and the Ansible collections that seem to be causing the most grief. (One team looks after ZOAU and another Ansible). They wondered of the documentation for the pre-requisites of each could be made better/clearer?

The collection dependency requirements are not clear in the documentation (https://ibm.github.io/z_ansible_collections_doc/ibm_zos_core/docs/source/requirements_managed.html).

Customers would like to know what versions of python and ZOAU they should install in order to run a certain version of Ansible (or specifically, the z/OS core collection).

Possible solutions

  1. Outline the collections lifecycle and the collection dependencies in the documentation. Revisit other information in the requirements as well.
  2. Embed the dependencies information in the README which travels AAP, Galaxy and GitHub releases.

For more information, see the slack thread: https://ibm-systems-z.slack.com/archives/CGRPT7DRP/p1705338495015539