diff --git a/lib/ansible/modules/system/reboot.py b/lib/ansible/modules/system/reboot.py
index 0c15f8a357..ad611f5fb9 100644
--- a/lib/ansible/modules/system/reboot.py
+++ b/lib/ansible/modules/system/reboot.py
@@ -53,17 +53,19 @@ options:
       - Message to display to users before reboot.
     default: Reboot initiated by Ansible
     type: str
+notes:
+    - For Windows targets, use the M(win_reboot) module instead.
 author:
     - Matt Davis (@nitzmahone)
     - Sam Doran (@samdoran)
 '''
 
 EXAMPLES = r'''
-# Unconditionally reboot the machine with all defaults
-- reboot:
+- name: Unconditionally reboot the machine with all defaults
+  reboot:
 
-# Reboot a slow machine that might have lots of updates to apply
-- reboot:
+- name: Reboot a slow machine that might have lots of updates to apply
+  reboot:
     reboot_timeout: 3600
 '''
 
diff --git a/lib/ansible/modules/windows/win_reboot.py b/lib/ansible/modules/windows/win_reboot.py
index dc0131f415..b15fd81d7a 100644
--- a/lib/ansible/modules/windows/win_reboot.py
+++ b/lib/ansible/modules/windows/win_reboot.py
@@ -60,6 +60,7 @@ options:
     default: Reboot initiated by Ansible
 notes:
 - If a shutdown was already scheduled on the system, C(win_reboot) will abort the scheduled shutdown and enforce its own shutdown.
+- For non-Windows targets, use the M(reboot) module instead.
 author:
     - Matt Davis (@nitzmahone)
 '''