Improve module docs (#2638)

source_control/github_key.py

@@ -54,18 +54,20 @@ author: Robert Estelle (@erydo)
 
 RETURN = '''
 deleted_keys:
-    description: Keys that were deleted, if any.
+    description: An array of key objects that were deleted. Only present on state=absent
-    returned: When state=absent
     type: list
-
+    returned: When state=absent
+    sample: [{'id': 0, 'key': 'BASE64 encoded key', 'url': 'http://example.com/github key', 'created_at': 'YYYY-MM-DDTHH:MM:SZ', 'read_only': False}]
 matching_keys:
-    description: Keys that match the specified name.
+    description: An array of keys matching the specified name. Only present on state=present
-    returned: When state=present
     type: list
-
+    returned: When state=present
+    sample: [{'id': 0, 'key': 'BASE64 encoded key', 'url': 'http://example.com/github key', 'created_at': 'YYYY-MM-DDTHH:MM:SZ', 'read_only': False}]
 key:
-    description: The key created.
+    description: Metadata about the key just created. Only present on state=present
-    returned: When state=present and a new key is created.
+    type: dict
+    returned: success
+    sample: {'id': 0, 'key': 'BASE64 encoded key', 'url': 'http://example.com/github key', 'created_at': 'YYYY-MM-DDTHH:MM:SZ', 'read_only': False}
 '''
 
 EXAMPLES = '''