[1]DOCS: add warning about relying on indirect dependencies

[acozine]

SUMMARY

At the community meeting on Oct. 28, 2020, we agreed to merge ansible-collections/community.general#1191 and remove community.general's dependency on ansible.posix in a minor release. We debated whether or not this constituted a "breaking change". The consensus: we do not consider this a breaking change, but we should update the docs to warn users not to rely on indirect dependencies.

Add a warning to https://docs.ansible.com/ansible/devel/user_guide/collections_using.html for sure, possibly to other pages as well.

ISSUE TYPE

• Documentation Report

COMPONENT NAME

docs.ansible.com

ANSIBLE VERSION

2.10

CONFIGURATION

N/A

OS / ENVIRONMENT

N/A

[ansibot]

Files identified in the description:

• docs/docsite/README.md

If these files are incorrect, please update the component name section of the description or use the !component bot command.

click here for bot help

[samccann]

Documentation fix:
At https://github.com/ansible/ansible/blame/devel/docs/docsite/rst/user_guide/collections_using.rst#L249 Add the following note

.. note::
You may see additional collections here that were added as dependencies of your installed collections. Only use collections in your playbooks that you have directly installed.

[Dule-martins]

Hye @samccann

I tried locating the file via the above link just to see that the page has been moved to collections_index
Now, I have been trying to locate the collections_index file.

[samccann]

Sorry about that @Dule-mart - the location to make that change is now at https://github.com/ansible/ansible/blame/devel/docs/docsite/rst/collections_guide/collections_listing.rst#L26

[Dule-martins]

Is fine, @samccann you have always been a lifesaver when it comes to this ❤️️❤️️

[JaroslavKlech]

@samccann, @acozine, can we close this issue, or more notes need to be added anywhere else?

[samccann]

@JaroslavKlech thanks for checking and yes this is fixed by #78785 so closing now and thanks @Dule-martins !