From c4ba77ece6ac4d973319269c556be4857c5d9d75 Mon Sep 17 00:00:00 2001 From: JohnPss Date: Sat, 26 Jul 2025 12:58:49 -0300 Subject: [PATCH] docs(config): Clarify deprecation warning for ansible_managed The deprecation message for the ansible_managed setting in ansible.cfg was confusing as it referenced an internal variable. This change updates the 'why' and 'alternative' fields in the configuration definition to provide a clearer and more direct message to the user. --- lib/ansible/config/base.yml | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/lib/ansible/config/base.yml b/lib/ansible/config/base.yml index ad28844b8c2..63f865b9e63 100644 --- a/lib/ansible/config/base.yml +++ b/lib/ansible/config/base.yml @@ -946,9 +946,10 @@ DEFAULT_MANAGED_STR: - {key: ansible_managed, section: defaults} yaml: {key: defaults.ansible_managed} deprecated: - why: The `ansible_managed` variable can be set just like any other variable, or a different variable can be used. - version: "2.23" - alternatives: Set the `ansible_managed` variable, or use any custom variable in templates. + why: The 'ansible_managed' setting in ansible.cfg is deprecated. Its name was confusing and it's better to set 'ansible_managed' as a normal variable. + alternative: To control the content of the 'ansible_managed' magic variable, set it as a variable in your inventory, playbooks, or roles instead of using this setting. + version: '2.23' + removed: False DEFAULT_MODULE_ARGS: name: Adhoc default arguments default: ~