better sudo/su deprecation on config entries (#36074)

* better sudo/su deprecation on config entries

fixes #32130

* typo fixes

* Copy edit

* Fixed more instances

lib/ansible/config/base.yml

@@ -360,7 +360,7 @@ DEFAULT_ASK_SUDO_PASS:
   name: Ask for the sudo password
   default: False
   deprecated:
-    why: In favor of become which is a generic framework
+    why: In favor of Ansible Become, which is a generic framework. See become_ask_pass.
     version: "2.8"
     alternatives: become
   description:
@@ -373,7 +373,7 @@ DEFAULT_ASK_SU_PASS:
   name: Ask for the su password
   default: False
   deprecated:
-    why: In favor of become which is a generic framework
+    why: In favor of Ansible Become, which is a generic framework. See become_ask_pass.
     version: "2.8"
     alternatives: become
   description:
@@ -988,7 +988,7 @@ DEFAULT_SU:
 DEFAULT_SUDO:
   default: False
   deprecated:
-    why: In favor of become which is a generic framework
+    why: In favor of Ansible Become, which is a generic framework
     version: "2.8"
     alternatives: become
   description: 'Toggle the use of "sudo" for tasks.'
@@ -1000,7 +1000,7 @@ DEFAULT_SUDO_EXE:
   name: sudo executable
   default: sudo
   deprecated:
-    why: In favor of become which is a generic framework
+    why: In favor of Ansible Become, which is a generic framework. See become_exe.
     version: "2.8"
     alternatives: become
   description: 'specify an "sudo" executable, otherwise it relies on PATH.'
@@ -1011,7 +1011,7 @@ DEFAULT_SUDO_FLAGS:
   name: sudo flags
   default: '-H -S -n'
   deprecated:
-    why: In favor of become which is a generic framework
+    why: In favor of Ansible Become, which is a generic framework. See become_flags.
     version: "2.8"
     alternatives: become
   description: 'Flags to pass to "sudo"'
@@ -1022,7 +1022,7 @@ DEFAULT_SUDO_USER:
   name: sudo user
   default:
   deprecated:
-    why: In favor of become which is a generic framework
+    why: In favor of Ansible Become, which is a generic framework. See become_user.
     version: "2.8"
     alternatives: become
   description: 'User you become when using "sudo", leaving it blank will use the default configured on the target (normally root)'
@@ -1033,7 +1033,7 @@ DEFAULT_SU_EXE:
   name: su executable
   default: su
   deprecated:
-    why: In favor of become which is a generic framework
+    why: In favor of Ansible Become, which is a generic framework. See become_exe.
     version: "2.8"
     alternatives: become
   description: 'specify an "su" executable, otherwise it relies on PATH.'
@@ -1044,7 +1044,7 @@ DEFAULT_SU_FLAGS:
   name: su flags
   default: ''
   deprecated:
-    why: In favor of become which is a generic framework
+    why: In favor of Ansible Become, which is a generic framework. See become_flags.
     version: "2.8"
     alternatives: become
   description: 'Flags to pass to su'
@@ -1059,7 +1059,7 @@ DEFAULT_SU_USER:
   ini:
   - {key: su_user, section: defaults}
   deprecated:
-    why: In favor of become which is a generic framework
+    why: In favor of Ansible Become, which is a generic framework. See become_user.
     version: "2.8"
     alternatives: become
 DEFAULT_SYSLOG_FACILITY: