more context on multiple facts modules (#77896)

1 files changed, 5 insertions, 1 deletions

diff --git a/lib/ansible/config/base.yml b/lib/ansible/config/base.yml
index c3124b2838..ff1614299c 100644
--- a/lib/ansible/config/base.yml
+++ b/lib/ansible/config/base.yml
@@ -1317,7 +1317,11 @@ FACTS_MODULES:
   name: Gather Facts Modules
   default:
     - smart
-  description: "Which modules to run during a play's fact gathering stage, using the default of 'smart' will try to figure it out based on connection type."
+  description:
+    - "Which modules to run during a play's fact gathering stage, using the default of 'smart' will try to figure it out based on connection type."
+    - "If adding your own modules but you still want to use the default Ansible facts, you will want to include 'setup'
+      or corresponding network module to the list (if you add 'smart', Ansible will also figure it out)."
+    - "This does not affect explicit calls to the 'setup' module, but does always affect the 'gather_facts' action (implicit or explicit)."
   env: [{name: ANSIBLE_FACTS_MODULES}]
   ini:
     - {key: facts_modules, section: defaults}