# How to get our collection doc added into the collection index section?

**URL:** <https://forum.ansible.com/t/how-to-get-our-collection-doc-added-into-the-collection-index-section/44738>\
**Category:** Get Help\
**Tags:** community-wg, galaxy-ng\
**Created:** [October 24, 2025, 4:17pm UTC](https://forum.ansible.com/t/how-to-get-our-collection-doc-added-into-the-collection-index-section/44738 "2025-10-24T16:17:30Z")\
**Posts on this page:** 7\
**Page:** 1

<div class="post-metadata">

**Author:** ![fernandofloresg](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/fernandofloresg/32/7811_2.png) [@fernandofloresg](https://forum.ansible.com/u/fernandofloresg)\
**Post date:** [October 24, 2025, 4:17pm UTC](https://forum.ansible.com/t/how-to-get-our-collection-doc-added-into-the-collection-index-section/44738/1 "2025-10-24T16:17:30Z")

</div>

**Please replace this text with a description of your issue**. You should:

Hi All! I’m a maintainer of the ibm\_zos\_core collection ([GitHub - ansible-collections/ibm\_zos\_core: Red Hat Ansible Certified Content for IBM Z](https://github.com/ansible-collections/ibm_zos_core)) we’ve been releasing content to Galaxy and Automation Platform for about 5 years now.

Now we are looking to get our documentation added into the collection index section ([Collection Index — Ansible Community Documentation](https://docs.ansible.com/ansible/latest/collections/index.html)), I found this ansible-inclusion ([GitHub - ansible-collections/ansible-inclusion: Requests to include new collections into the ansible package](https://github.com/ansible-collections/ansible-inclusion?tab=readme-ov-file)) repo but seems to be for a collection to get included into the community package which is not what I’m looking for at the moment. At this point I just want our collection docs to be added into the collection index section. Is there a guide to do that?

```auto
- my code!

```

- Set at least one tag (the experts follow the tags, so the right people will find you if you tag)

---

<div class="post-metadata">

**Author:** ![samccann](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/samccann/32/18_2.png) [@samccann](https://forum.ansible.com/u/samccann)\
**Post date:** [October 24, 2025, 4:20pm UTC](https://forum.ansible.com/t/how-to-get-our-collection-doc-added-into-the-collection-index-section/44738/2 "2025-10-24T16:20:15Z")

</div>

Hi @fernandofloresg -

The collections on [docs.ansible.com](http://docs.ansible.com) are only for collections within the Ansible community package.

Certified collections are documented on Red Hat’s Software Catalog. You can see [your collection here.](https://catalog.redhat.com/en/software/collection/ibm/ibm_zos_core#overview)

---

<div class="post-metadata">

**Author:** ![fernandofloresg](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/fernandofloresg/32/7811_2.png) [@fernandofloresg](https://forum.ansible.com/u/fernandofloresg)\
**Post date:** [October 24, 2025, 4:22pm UTC](https://forum.ansible.com/t/how-to-get-our-collection-doc-added-into-the-collection-index-section/44738/3 "2025-10-24T16:22:57Z")

</div>

So that means that if I want my collection to appear in [docs.ansible.com](http://docs.ansible.com) I need to follow the ansible inclusion process right?

---

<div class="post-metadata">

**Author:** ![bcoca](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/bcoca/32/9269_2.png) [@bcoca](https://forum.ansible.com/u/bcoca)\
**Post date:** [October 24, 2025, 4:27pm UTC](https://forum.ansible.com/t/how-to-get-our-collection-doc-added-into-the-collection-index-section/44738/4 "2025-10-24T16:27:04Z")

</div>

yes, that is correct

---

<div class="post-metadata">

**Author:** ![mariolenz](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/mariolenz/32/108_2.png) [@mariolenz](https://forum.ansible.com/u/mariolenz)\
**Post date:** [October 24, 2025, 5:44pm UTC](https://forum.ansible.com/t/how-to-get-our-collection-doc-added-into-the-collection-index-section/44738/5 "2025-10-24T17:44:00Z")

</div>

I’m not sure if it’s a good idea to add this collection to the Ansible Community Package _only_ to make the documentation show up on [docs.ansible.com](http://docs.ansible.com). ATM it feels like we have a lot of problems with collections that wanted to be part of the ACP for whatever reasons, but don’t really follow our rules…

On the other hand, if you want your collection to be added to ACP and are fine with our [ollections requirements](https://docs.ansible.com/ansible/latest/community/collection_contributors/collection_requirements.html): Feel free to ask about inclusion to ACP.

Maybe we should make it clearer that the collection index is only about collections included in the Ansible Community Package? I think we don’t state this explicitly just now.

Another idea, since it looks like this collection is RH certified: Have a `Certified Collections index` on [docs.ansible.com](http://docs.ansible.com).

@fernandofloresg Do you have any additional documentation in your collection to show up? If not, tell your users to look it up on [galaxy](https://galaxy.ansible.com/ui/repo/published/ibm/ibm_zos_core/docs/). I think it’s even easier to find the documentation on the version you’re using there than anywhere else.

That is, if you don’t rely on code and documentation from other collections. Look [here](https://forum.ansible.com/t/3496) why this isn’t easy, or even impossible.

---

<div class="post-metadata">

**Author:** ![fernandofloresg](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/fernandofloresg/32/7811_2.png) [@fernandofloresg](https://forum.ansible.com/u/fernandofloresg)\
**Post date:** [October 30, 2025, 3:00pm UTC](https://forum.ansible.com/t/how-to-get-our-collection-doc-added-into-the-collection-index-section/44738/6 "2025-10-30T15:00:25Z")

</div>

Thanks @mariolenz. We do have a dedicated docs site for our collection, I was just exploring the possibility of having it in [ansible.com](http://ansible.com) too, but if that is reserved for ACP that’s ok. We don’t have intention for it to be added into ACP at the moment.

Having a Certified Collections index looks like a good idea, our intention was to have extra visibility from users exploring [ansible.com](http://ansible.com) docs.

---

<div class="post-metadata">

**Author:** ![system](https://us1.discourse-cdn.com/ansible/original/1X/1882d9a01da5d8996a862359b0913cc568a39b84.svg) [@system](https://forum.ansible.com/u/system)\
**Post date:** [November 29, 2025, 3:01pm UTC](https://forum.ansible.com/t/how-to-get-our-collection-doc-added-into-the-collection-index-section/44738/7 "2025-11-29T15:01:06Z")

</div>

Closed on November 29, 2025, 3:01pm UTC

This topic was automatically closed 30 days after the last reply. New replies are no longer allowed.
