win_chocolately document improvedments, mention win_hotfix and use of become (#31085)

lib/ansible/modules/windows/win_chocolatey.py

@@ -133,6 +133,9 @@ notes:
 - When using verbosity 4 (C(-vvvv)) the C(stdout) output will be more verbose.
 - When using verbosity 5 (C(-vvvvv)) the C(stdout) output will include debug output.
 - This module will install or upgrade Chocolatey when needed.
+- Some packages need an interactive user logon in order to install.  You can use (C(become)) to achieve this.
+- Even if you are connecting as local Administrator, using (C(become)) to become Administrator will give you an interactive user logon, see examples below.
+- Use (M(win_hotfix) to install hotfixes instead of (M(win_chocolatey)) as (M(win_hotfix)) avoids using wusa.exe which cannot be run remotely.
 author:
 - Trond Hindenes (@trondhindenes)
 - Peter Mounce (@petemounce)
@@ -173,10 +176,10 @@ EXAMPLES = r'''
     name: git
     state: absent
 
-- name: install multiple packages
+- name: Install multiple packages
   win_chocolatey:
     name: '{{ item }}'
-    state: absent
+    state: present
   with_items:
   - pscx
   - windirstat
@@ -202,6 +205,13 @@ EXAMPLES = r'''
     proxy_url: http://proxy-server:8080/
     proxy_username: user with \"escaped\" double quotes
     proxy_password: pass with \"escaped\" double quotes
+
+- name: Install a package that requires 'become'
+  win_chocolatey:
+    name: officepro2013
+  become: yes
+  become_user: Administrator
+  become_method: runas
 '''
 
 RETURN = r'''