updated cache descriptions

lib/ansible/plugins/cache/jsonfile.py

@@ -17,9 +17,9 @@
 '''
 DOCUMENTATION:
     cache: jsonfile
-    short_description: File backed, JSON formated.
+    short_description: JSON formatted files.
     description:
-        - File backed cache that uses JSON as a format, the files are per host.
+        - This cache uses JSON formatted, per host, files saved to the filesystem.
     version_added: "1.9"
     author: Brian Coca (@bcoca)
 '''

lib/ansible/plugins/cache/pickle.py

@@ -17,9 +17,9 @@
 '''
 DOCUMENTATION:
     cache: yaml
-    short_description: File backed, using Python's pickle.
+    short_description: Pickle formatted files.
     description:
-        - File backed cache that uses Python's pickle serialization as a format, the files are per host.
+        - This cache uses Python's pickle serialization format, in per host files, saved to the filesystem.
     version_added: "2.3"
     author: Brian Coca (@bcoca)
 '''

lib/ansible/plugins/cache/yaml.py

@@ -17,9 +17,9 @@
 '''
 DOCUMENTATION:
     cache: yaml
-    short_description: File backed, YAML formated.
+    short_description: YAML formatted files.
     description:
-        - File backed cache that uses YAML as a format, the files are per host.
+        - This cache uses YAML formatted, per host, files saved to the filesystem.
     version_added: "2.3"
     author: Brian Coca (@bcoca)
 '''