diff --git a/library/rax b/library/rax
index 2bdc163824..eabd6ffbf5 100644
--- a/library/rax
+++ b/library/rax
@@ -17,42 +17,36 @@
 DOCUMENTATION = '''
 ---
 module: rax
-short_description: create an instance in Rackspace Public Cloud, return instanceid
+short_description: create / delete an instance in Rackspace Public Cloud
 description:
-     - creates Rackspace Public Cloud instances and optionally waits for it to be 'running'.
+     - creates / deletes Rackspace Public Cloud instances and optionally waits for it to be 'running'.
 version_added: "1.2"
 options:
   service:
     description:
      - Cloud service to interact with
-    required: false
-    choices: ['cloudservers', 'cloudfiles', 'cloud_databases', 'cloud_loadbalancers']
+    choices: ['cloudservers']
     default: cloudservers
   state:
     description:
      - Indicate desired state of the resource
-    required: false
     choices: ['present', 'active', 'absent', 'deleted']
     default: present
   creds_file:
     description:
      - File to find the Rackspace Public Cloud credentials in
-    required: false
     default: null
   name:
     description:
      - Name to give the instance
-    required: false
     default: null
   flavor:
     description:
      - flavor to use for the instance
-    required: false
     default: null
   image:
     description:
      - image to use for the instance
-    required: false
     default: null
   meta:
     description:
@@ -61,7 +55,6 @@ options:
   key_name:
     description:
      - key pair to use on the instance
-    required: false
     default: null
     aliases: ['keypair']
   files:
@@ -71,12 +64,10 @@ options:
   region:
     description:
      - Region to create an instance in
-    required: false
     default: null
   wait:
     description:
      - wait for the instance to be in state 'running' before returning
-    required: false
     default: "no"
     choices: [ "yes", "no" ]
   wait_timeout:
@@ -84,8 +75,18 @@ options:
      - how long before wait gives up, in seconds
     default: 300
 examples:
-   - code: 'local_action: rax creds_file=~/.raxpub service=cloudservers name=rax-test1 flavor=5 image=b11d9567-e412-4255-96b9-bd63ab23bcfe wait=yes state=present'
-     description: "Examples from Ansible Playbooks"
+   - code: |
+           - name: Create a server
+             local_action:
+               module: rax
+               creds_file: ~/.raxpub
+               service: cloudservers
+               name: rax-test1
+               flavor: 5
+               image: b11d9567-e412-4255-96b9-bd63ab23bcfe
+               wait: yes
+               state: present
+     description: "Example from Ansible Playbooks"
 requirements: [ "pyrax" ]
 author: Jesse Keating
 notes: