prompt: We are currently solving the following issue within our repository. Here is the issue text:
  --- BEGIN ISSUE ---
  win_domain_controller: documentation error in examples '_pass' should be '_password'
  <!---
  Verify first that your issue/request is not already reported on GitHub.
  Also test if the latest release, and master branch are affected too.
  -->
  
  ##### ISSUE TYPE
  <!--- Pick one below and delete the rest: -->
  
   - Documentation Report
  
  ##### COMPONENT NAME
  <!--- Name of the module/plugin/task/feature -->
  win_domain_controller
  ##### ANSIBLE VERSION
  <!--- Paste verbatim output from “ansible --version” between quotes below -->
  ```
  ansible 2.3.0.0 (detached HEAD e4494f85b6) last updated 2017/03/17 12:34:17 (GMT +100)
    config file = /home/jon/ansible/ansible.cfg
    configured module search path = [u'/home/jon/ansible/library']
    python version = 2.7.6 (default, Jun 22 2015, 17:58:13) [GCC 4.8.2]
  ```
  
  ##### CONFIGURATION
  <!---
  Mention any settings you have changed/added/removed in ansible.cfg
  (or using the ANSIBLE_* environment variables).
  -->
  
  ##### OS / ENVIRONMENT
  <!---
  Mention the OS you are running Ansible from, and the OS you are
  managing, or say “N/A” for anything that is not platform-specific.
  -->
  Ansible controller Windows 10 WSL (ubuntu)
  targets: Windows Server 2012 R2
  ##### SUMMARY
  <!--- Explain the problem briefly -->
  
  The examples need updating to match the correct parameter names for the _password parameters.
  For example in the examples domain_admin_pass, but the module actually expects 'domain_admin_password'.  The same thing is true for 'safe_mode_password' and 'local_admin_password'.
  
  Would create a PR for this but am away from dev machine at the moment.
  
  
  ##### STEPS TO REPRODUCE
  <!---
  For bugs, show exactly how to reproduce the problem, using a minimal test-case.
  For new features, show how the feature would be used.
  -->
  N/A
  <!--- Paste example playbooks or commands between quotes below -->
  ```yaml
  
  ```
  
  <!--- You can also paste gist.github.com links for larger files -->
  
  ##### EXPECTED RESULTS
  <!--- What did you expect to happen when running the steps above? -->
  N/A
  ##### ACTUAL RESULTS
  <!--- What actually happened? If possible run with extra verbosity (-vvvv) -->
  N/A
  <!--- Paste verbatim command output between quotes below -->
  ```
  
  ```
  
  
  --- END ISSUE ---
  
  Below are some code segments, each from a relevant file. One or more of these files may contain bugs.
  --- BEGIN FILES ---
  Path: `lib/ansible/modules/windows/win_domain_controller.py`
  Content:
  ```
  1 #!/usr/bin/python
  2 # -*- coding: utf-8 -*-
  3 
  4 # (c) 2017, Red Hat, Inc.
  5 #
  6 # This file is part of Ansible
  7 #
  8 # Ansible is free software: you can redistribute it and/or modify
  9 # it under the terms of the GNU General Public License as published by
  10 # the Free Software Foundation, either version 3 of the License, or
  11 # (at your option) any later version.
  12 #
  13 # Ansible is distributed in the hope that it will be useful,
  14 # but WITHOUT ANY WARRANTY; without even the implied warranty of
  15 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  16 # GNU General Public License for more details.
  17 #
  18 # You should have received a copy of the GNU General Public License
  19 # along with Ansible.  If not, see <http://www.gnu.org/licenses/>.
  20 
  21 ANSIBLE_METADATA = {'metadata_version': '1.0',
  22                     'status': ['preview'],
  23                     'supported_by': 'core'}
  24 
  25 
  26 DOCUMENTATION='''
  27 module: win_domain_controller
  28 short_description: Manage domain controller/member server state for a Windows host
  29 version_added: 2.3
  30 description:
  31      - Ensure that a Windows Server 2012+ host is configured as a domain controller or demoted to member server. This module may require
  32        subsequent use of the M(win_reboot) action if changes are made.
  33 options:
  34   dns_domain_name:
  35     description:
  36       - when C(state) is C(domain_controller), the DNS name of the domain for which the targeted Windows host should be a DC
  37   domain_admin_user:
  38     description:
  39       - username of a domain admin for the target domain (necessary to promote or demote a domain controller)
  40     required: true
  41   domain_admin_password:
  42     description:
  43       - password for the specified C(domain_admin_user)
  44     required: true
  45   safe_mode_password:
  46     description:
  47       - safe mode password for the domain controller (required when C(state) is C(domain_controller))
  48   local_admin_password:
  49     description:
  50       - password to be assigned to the local C(Administrator) user (required when C(state) is C(member_server))
  51   state:
  52     description:
  53       - whether the target host should be a domain controller or a member server
  54     choices:
  55       - domain_controller
  56       - member_server
  57 author:
  58     - Matt Davis (@nitzmahone)
  59 '''
  60 
  61 RETURN='''
  62 reboot_required:
  63     description: True if changes were made that require a reboot.
  64     returned: always
  65     type: boolean
  66     sample: true
  67 
  68 '''
  69 
  70 EXAMPLES=r'''
  71 # ensure a server is a domain controller
  72 - hosts: winclient
  73   gather_facts: no
  74   tasks:
  75   - win_domain_controller:
  76       dns_domain_name: ansible.vagrant
  77       domain_admin_user: testguy@ansible.vagrant
  78       domain_admin_pass: password123!
  79       safe_mode_pass: password123!
  80       state: domain_controller
  81       log_path: c:\ansible_win_domain_controller.txt
  82 
  83 # ensure a server is not a domain controller
  84 # note that without an action wrapper, in the case where a DC is demoted,
  85 # the task will fail with a 401 Unauthorized, because the domain credential
  86 # becomes invalid to fetch the final output over WinRM. This requires win_async
  87 # with credential switching (or other clever credential-switching
  88 # mechanism to get the output and trigger the required reboot)
  89 - hosts: winclient
  90   gather_facts: no
  91   tasks:
  92   - win_domain_controller:
  93       domain_admin_user: testguy@ansible.vagrant
  94       domain_admin_pass: password123!
  95       local_admin_pass: password123!
  96       state: member_server
  97       log_path: c:\ansible_win_domain_controller.txt
  98 
  99 '''
  100 
  101
  ```
  --- END FILES ---
  
  Please first localize the bug based on the issue statement, and then generate a patch according to the `git diff` format fenced by three backticks.
  
  Here is an example:
  
  ```diff
  diff --git a/examples/server_async.py b/examples/server_async.py
  --- a/examples/server_async.py
  +++ b/examples/server_async.py
  @@ -313,4 +313,4 @@
   
   
   if __name__ == "__main__":
  -    asyncio.run(run_async_server("."), debug=True)
  +    asyncio.run(run_async_server(), debug=True)
  diff --git a/examples/server_sync.py b/examples/server_sync.py
  --- a/examples/server_sync.py
  +++ b/examples/server_sync.py
  @@ -313,5 +313,5 @@
   
   
   if __name__ == "__main__":
  -    server = run_sync_server(".")
  +    server = run_sync_server()
       server.shutdown()
  
  ```
  
golden_diff: diff --git a/lib/ansible/modules/windows/win_domain_controller.py b/lib/ansible/modules/windows/win_domain_controller.py
  --- a/lib/ansible/modules/windows/win_domain_controller.py
  +++ b/lib/ansible/modules/windows/win_domain_controller.py
  @@ -75,8 +75,8 @@
     - win_domain_controller:
         dns_domain_name: ansible.vagrant
         domain_admin_user: testguy@ansible.vagrant
  -      domain_admin_pass: password123!
  -      safe_mode_pass: password123!
  +      domain_admin_password: password123!
  +      safe_mode_password: password123!
         state: domain_controller
         log_path: c:\ansible_win_domain_controller.txt
   
  @@ -91,8 +91,8 @@
     tasks:
     - win_domain_controller:
         domain_admin_user: testguy@ansible.vagrant
  -      domain_admin_pass: password123!
  -      local_admin_pass: password123!
  +      domain_admin_password: password123!
  +      local_admin_password: password123!
         state: member_server
         log_path: c:\ansible_win_domain_controller.txt
  
verification_info: {"golden_diff": "diff --git a/lib/ansible/modules/windows/win_domain_controller.py b/lib/ansible/modules/windows/win_domain_controller.py\n--- a/lib/ansible/modules/windows/win_domain_controller.py\n+++ b/lib/ansible/modules/windows/win_domain_controller.py\n@@ -75,8 +75,8 @@\n   - win_domain_controller:\n       dns_domain_name: ansible.vagrant\n       domain_admin_user: testguy@ansible.vagrant\n-      domain_admin_pass: password123!\n-      safe_mode_pass: password123!\n+      domain_admin_password: password123!\n+      safe_mode_password: password123!\n       state: domain_controller\n       log_path: c:\\ansible_win_domain_controller.txt\n \n@@ -91,8 +91,8 @@\n   tasks:\n   - win_domain_controller:\n       domain_admin_user: testguy@ansible.vagrant\n-      domain_admin_pass: password123!\n-      local_admin_pass: password123!\n+      domain_admin_password: password123!\n+      local_admin_password: password123!\n       state: member_server\n       log_path: c:\\ansible_win_domain_controller.txt\n", "issue": "win_domain_controller: documentation error in examples '_pass' should be '_password'\n<!---\r\nVerify first that your issue/request is not already reported on GitHub.\r\nAlso test if the latest release, and master branch are affected too.\r\n-->\r\n\r\n##### ISSUE TYPE\r\n<!--- Pick one below and delete the rest: -->\r\n\r\n - Documentation Report\r\n\r\n##### COMPONENT NAME\r\n<!--- Name of the module/plugin/task/feature -->\r\nwin_domain_controller\r\n##### ANSIBLE VERSION\r\n<!--- Paste verbatim output from \u201cansible --version\u201d between quotes below -->\r\n```\r\nansible 2.3.0.0 (detached HEAD e4494f85b6) last updated 2017/03/17 12:34:17 (GMT +100)\r\n  config file = /home/jon/ansible/ansible.cfg\r\n  configured module search path = [u'/home/jon/ansible/library']\r\n  python version = 2.7.6 (default, Jun 22 2015, 17:58:13) [GCC 4.8.2]\r\n```\r\n\r\n##### CONFIGURATION\r\n<!---\r\nMention any settings you have changed/added/removed in ansible.cfg\r\n(or using the ANSIBLE_* environment variables).\r\n-->\r\n\r\n##### OS / ENVIRONMENT\r\n<!---\r\nMention the OS you are running Ansible from, and the OS you are\r\nmanaging, or say \u201cN/A\u201d for anything that is not platform-specific.\r\n-->\r\nAnsible controller Windows 10 WSL (ubuntu)\r\ntargets: Windows Server 2012 R2\r\n##### SUMMARY\r\n<!--- Explain the problem briefly -->\r\n\r\nThe examples need updating to match the correct parameter names for the _password parameters.\r\nFor example in the examples domain_admin_pass, but the module actually expects 'domain_admin_password'.  The same thing is true for 'safe_mode_password' and 'local_admin_password'.\r\n\r\nWould create a PR for this but am away from dev machine at the moment.\r\n\r\n\r\n##### STEPS TO REPRODUCE\r\n<!---\r\nFor bugs, show exactly how to reproduce the problem, using a minimal test-case.\r\nFor new features, show how the feature would be used.\r\n-->\r\nN/A\r\n<!--- Paste example playbooks or commands between quotes below -->\r\n```yaml\r\n\r\n```\r\n\r\n<!--- You can also paste gist.github.com links for larger files -->\r\n\r\n##### EXPECTED RESULTS\r\n<!--- What did you expect to happen when running the steps above? -->\r\nN/A\r\n##### ACTUAL RESULTS\r\n<!--- What actually happened? If possible run with extra verbosity (-vvvv) -->\r\nN/A\r\n<!--- Paste verbatim command output between quotes below -->\r\n```\r\n\r\n```\r\n\n", "before_files": [{"content": "#!/usr/bin/python\n# -*- coding: utf-8 -*-\n\n# (c) 2017, Red Hat, Inc.\n#\n# This file is part of Ansible\n#\n# Ansible is free software: you can redistribute it and/or modify\n# it under the terms of the GNU General Public License as published by\n# the Free Software Foundation, either version 3 of the License, or\n# (at your option) any later version.\n#\n# Ansible is distributed in the hope that it will be useful,\n# but WITHOUT ANY WARRANTY; without even the implied warranty of\n# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the\n# GNU General Public License for more details.\n#\n# You should have received a copy of the GNU General Public License\n# along with Ansible.  If not, see <http://www.gnu.org/licenses/>.\n\nANSIBLE_METADATA = {'metadata_version': '1.0',\n                    'status': ['preview'],\n                    'supported_by': 'core'}\n\n\nDOCUMENTATION='''\nmodule: win_domain_controller\nshort_description: Manage domain controller/member server state for a Windows host\nversion_added: 2.3\ndescription:\n     - Ensure that a Windows Server 2012+ host is configured as a domain controller or demoted to member server. This module may require\n       subsequent use of the M(win_reboot) action if changes are made.\noptions:\n  dns_domain_name:\n    description:\n      - when C(state) is C(domain_controller), the DNS name of the domain for which the targeted Windows host should be a DC\n  domain_admin_user:\n    description:\n      - username of a domain admin for the target domain (necessary to promote or demote a domain controller)\n    required: true\n  domain_admin_password:\n    description:\n      - password for the specified C(domain_admin_user)\n    required: true\n  safe_mode_password:\n    description:\n      - safe mode password for the domain controller (required when C(state) is C(domain_controller))\n  local_admin_password:\n    description:\n      - password to be assigned to the local C(Administrator) user (required when C(state) is C(member_server))\n  state:\n    description:\n      - whether the target host should be a domain controller or a member server\n    choices:\n      - domain_controller\n      - member_server\nauthor:\n    - Matt Davis (@nitzmahone)\n'''\n\nRETURN='''\nreboot_required:\n    description: True if changes were made that require a reboot.\n    returned: always\n    type: boolean\n    sample: true\n\n'''\n\nEXAMPLES=r'''\n# ensure a server is a domain controller\n- hosts: winclient\n  gather_facts: no\n  tasks:\n  - win_domain_controller:\n      dns_domain_name: ansible.vagrant\n      domain_admin_user: testguy@ansible.vagrant\n      domain_admin_pass: password123!\n      safe_mode_pass: password123!\n      state: domain_controller\n      log_path: c:\\ansible_win_domain_controller.txt\n\n# ensure a server is not a domain controller\n# note that without an action wrapper, in the case where a DC is demoted,\n# the task will fail with a 401 Unauthorized, because the domain credential\n# becomes invalid to fetch the final output over WinRM. This requires win_async\n# with credential switching (or other clever credential-switching\n# mechanism to get the output and trigger the required reboot)\n- hosts: winclient\n  gather_facts: no\n  tasks:\n  - win_domain_controller:\n      domain_admin_user: testguy@ansible.vagrant\n      domain_admin_pass: password123!\n      local_admin_pass: password123!\n      state: member_server\n      log_path: c:\\ansible_win_domain_controller.txt\n\n'''\n\n", "path": "lib/ansible/modules/windows/win_domain_controller.py"}], "after_files": [{"content": "#!/usr/bin/python\n# -*- coding: utf-8 -*-\n\n# (c) 2017, Red Hat, Inc.\n#\n# This file is part of Ansible\n#\n# Ansible is free software: you can redistribute it and/or modify\n# it under the terms of the GNU General Public License as published by\n# the Free Software Foundation, either version 3 of the License, or\n# (at your option) any later version.\n#\n# Ansible is distributed in the hope that it will be useful,\n# but WITHOUT ANY WARRANTY; without even the implied warranty of\n# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the\n# GNU General Public License for more details.\n#\n# You should have received a copy of the GNU General Public License\n# along with Ansible.  If not, see <http://www.gnu.org/licenses/>.\n\nANSIBLE_METADATA = {'metadata_version': '1.0',\n                    'status': ['preview'],\n                    'supported_by': 'core'}\n\n\nDOCUMENTATION='''\nmodule: win_domain_controller\nshort_description: Manage domain controller/member server state for a Windows host\nversion_added: 2.3\ndescription:\n     - Ensure that a Windows Server 2012+ host is configured as a domain controller or demoted to member server. This module may require\n       subsequent use of the M(win_reboot) action if changes are made.\noptions:\n  dns_domain_name:\n    description:\n      - when C(state) is C(domain_controller), the DNS name of the domain for which the targeted Windows host should be a DC\n  domain_admin_user:\n    description:\n      - username of a domain admin for the target domain (necessary to promote or demote a domain controller)\n    required: true\n  domain_admin_password:\n    description:\n      - password for the specified C(domain_admin_user)\n    required: true\n  safe_mode_password:\n    description:\n      - safe mode password for the domain controller (required when C(state) is C(domain_controller))\n  local_admin_password:\n    description:\n      - password to be assigned to the local C(Administrator) user (required when C(state) is C(member_server))\n  state:\n    description:\n      - whether the target host should be a domain controller or a member server\n    choices:\n      - domain_controller\n      - member_server\nauthor:\n    - Matt Davis (@nitzmahone)\n'''\n\nRETURN='''\nreboot_required:\n    description: True if changes were made that require a reboot.\n    returned: always\n    type: boolean\n    sample: true\n\n'''\n\nEXAMPLES=r'''\n# ensure a server is a domain controller\n- hosts: winclient\n  gather_facts: no\n  tasks:\n  - win_domain_controller:\n      dns_domain_name: ansible.vagrant\n      domain_admin_user: testguy@ansible.vagrant\n      domain_admin_password: password123!\n      safe_mode_password: password123!\n      state: domain_controller\n      log_path: c:\\ansible_win_domain_controller.txt\n\n# ensure a server is not a domain controller\n# note that without an action wrapper, in the case where a DC is demoted,\n# the task will fail with a 401 Unauthorized, because the domain credential\n# becomes invalid to fetch the final output over WinRM. This requires win_async\n# with credential switching (or other clever credential-switching\n# mechanism to get the output and trigger the required reboot)\n- hosts: winclient\n  gather_facts: no\n  tasks:\n  - win_domain_controller:\n      domain_admin_user: testguy@ansible.vagrant\n      domain_admin_password: password123!\n      local_admin_password: password123!\n      state: member_server\n      log_path: c:\\ansible_win_domain_controller.txt\n\n'''\n\n", "path": "lib/ansible/modules/windows/win_domain_controller.py"}]}