From 5314af84270321a82353579f14e9c214241c103d Mon Sep 17 00:00:00 2001
From: Andrew Klychkov <aaklychkov@mail.ru>
Date: Wed, 17 Jan 2024 13:00:51 +0100
Subject: [PATCH] collection_requirements: add meta/execution-environments.yml
 (#871)

* collection_requirements: add requirements.txt and bindep.txt

* Change

* Fix

* Update wrt recent builder docs update
---
 .../collection_contributors/collection_requirements.rst   | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/docs/docsite/rst/community/collection_contributors/collection_requirements.rst b/docs/docsite/rst/community/collection_contributors/collection_requirements.rst
index 69339cdf65e..58bbacb0411 100644
--- a/docs/docsite/rst/community/collection_contributors/collection_requirements.rst
+++ b/docs/docsite/rst/community/collection_contributors/collection_requirements.rst
@@ -156,6 +156,7 @@ Your collection repository MUST have a ``README.md`` in the root of the collecti
 
 meta/runtime.yml
 ----------------
+
 Example: `meta/runtime.yml <https://github.com/ansible-collections/collection_template/blob/main/meta/runtime.yml>`_
 
 * The ``meta/runtime.yml`` MUST define the minimum version of Ansible which this collection works with.
@@ -165,6 +166,13 @@ Example: `meta/runtime.yml <https://github.com/ansible-collections/collection_te
 
 .. _coll_module-reqs:
 
+meta/execution-environment.yml
+------------------------------
+
+If a collection has controller-side Python package and/or system package requirements, to allow easy `execution environment <https://ansible.readthedocs.io/en/latest/getting_started_ee/index.html>`_ building, they SHOULD be listed in corresponding files under the ``meta`` directory, specified in ``meta/execution-environment.yml``, and `verified <https://ansible.readthedocs.io/projects/builder/en/latest/collection_metadata/#when-installing-collections-using-ansible-galaxy>`_.
+
+See the `Collection-level dependencies guide <https://ansible.readthedocs.io/projects/builder/en/latest/collection_metadata/#collection-level-dependencies>`_ for more information and `collection_template/meta <https://github.com/ansible-collections/collection_template/tree/main/meta>` directory content as an example.
+
 Modules & Plugins
 ------------------