📝 Document macOS user deletion over SSH (#80358)

Co-authored-by: Matt Clay <matt@mystile.com>
Co-authored-by: Don Naro <dnaro@redhat.com>

docs/docsite/rst/reference_appendices/faq.rst

@@ -245,8 +245,8 @@ need to install them into the virtualenv. There are two methods:
       $ cp -v /usr/lib64/python3.*/site-packages/*selinux*.so ./py3-ansible/lib64/python3.*/site-packages/
 
 
-Running on macOS
-----------------
+Running on macOS as a controller
+--------------------------------
 
 When executing Ansible on a system with macOS as a controller machine one might encounter the following error:
 
@@ -261,6 +261,25 @@ In general the recommended workaround is to set the following environment variab
         $ export OBJC_DISABLE_INITIALIZE_FORK_SAFETY=YES
 
 
+.. _macos_as_a_target_faq:
+
+Running on macOS as a target
+----------------------------
+
+When managing a system with macOS Monterey 12, macOS Ventura
+13 or above over SSH, the following error can occur:
+
+  .. error::
+        "eDSPermissionError" DS Error: -14120 (eDSPermissionError)
+
+This is a good indication that *Allow full disk access for remote users* has not been enabled.
+
+.. seealso::
+
+   For more details, check out `the official Apple user guide article
+   <https://support.apple.com/guide/mac-help/mchlp1066/mac#mchlp1b6a98a>`_.
+
+
 Running on BSD
 --------------
 

lib/ansible/modules/user.py

@@ -97,6 +97,8 @@ options:
     state:
         description:
             - Whether the account should exist or not, taking action if the state is different from what is stated.
+            - See this L(FAQ entry,https://docs.ansible.com/ansible/latest/reference_appendices/faq.html#running-on-macos-as-a-target)
+              for additional requirements when removing users on macOS systems.
         type: str
         choices: [ absent, present ]
         default: present