Generate doc for IMS Collection release v1.3.0-beta.1 about z_ansible_collections_doc HOT 2 CLOSED

Thanks @ddimatos. The missing community guidelines is fixed and the doc has been generated and published for the v1.3.0-beta.1 release.

from z_ansible_collections_doc.

There is an issue with the doc from the remote repository, the repository to pull dock from was not shared so I am using the tag, assuming that is correct:

  ibm_zos_ims:
    git: [email protected]:ansible-collections/ibm_zos_ims.git
    stable:
    latest: release-v1.3.0-beta.1
    origin: main

Then the issue is when doc is consumed by this repositories tooling an error occurred:

/Users/ddimatos/git/gh/z_ansible_collections_doc/source/reference/community.rst:14: WARNING: toctree contains reference to nonexisting document 'ibm_zos_ims/docs/source/community_guides'
looking for now-outdated files... none found

What this means is the community_guides.rst is not available under for IMS but other collections are not impacted.

The easiest fix is to branch fro the tag release-v1.3.0-beta.1, lets call that release-v1.3.0-beta.1-docfix, fix the doc, then reply here so we can then pull from the branch release-v1.3.0-beta.1-docfix that includes community_guides.rst.

This is the current live view of the doc:

This is how it looks now notice there is no IMS section:

Since this is isolated to IMS , I will push the updated doc but you should plan to fix this in a new branch and open an isssue.

from z_ansible_collections_doc.