Deprecate returned facts. (#52518)

lib/ansible/modules/cloud/docker/docker_compose.py

@@ -307,7 +307,7 @@ service_facts:
   - A dictionary mapping the service's name to a dictionary of containers.
   - Note that facts are part of the registered vars since Ansible 2.8. For compatibility reasons, the facts
     are also accessible directly. The service's name is the variable with which the container dictionary
-    can be accessed.
+    can be accessed. Note that the returned facts will be removed in Ansible 2.12.
   returned: success
   type: complex
   contains:

lib/ansible/modules/cloud/docker/docker_container.py

@@ -878,7 +878,7 @@ docker_container:
       - Before 2.3 this was 'ansible_docker_container' but was renamed due to conflicts with the connection plugin.
       - Facts representing the current state of the container. Matches the docker inspection output.
       - Note that facts are part of the registered vars since Ansible 2.8. For compatibility reasons, the facts
-        are also accessible directly.
+        are also accessible directly. Note that the returned fact will be removed in Ansible 2.12.
       - Empty if C(state) is I(absent)
       - If detached is I(False), will include Output attribute containing any output from container run.
     returned: always

lib/ansible/modules/cloud/docker/docker_network.py

@@ -245,7 +245,7 @@ docker_network:
     description:
     - Network inspection results for the affected network.
     - Note that facts are part of the registered vars since Ansible 2.8. For compatibility reasons, the facts
-      are also accessible directly.
+      are also accessible directly. Note that the returned fact will be removed in Ansible 2.12.
     returned: success
     type: dict
     sample: {}

lib/ansible/modules/cloud/docker/docker_volume.py

@@ -119,7 +119,7 @@ docker_volume:
     description:
     - Volume inspection results for the affected volume.
     - Note that facts are part of the registered vars since Ansible 2.8. For compatibility reasons, the facts
-      are also accessible directly.
+      are also accessible directly. Note that the returned fact will be removed in Ansible 2.12.
     returned: success
     type: dict
     sample: {}