Clarify/update Redactor settings

Author: jasonvarga

content/collections/fieldtypes/redactor.md

@@ -5,12 +5,11 @@ image: 22318543-6610-45b9-b21b-d1bed3b2afe7
 options:
   -
     name: settings
-    type: array
+    type: string
     description: >
-      An array of settings to be passed into
-      the Redactor plugin. This should be a
-      YAML version of the Javascript object
-      you would use to initialize Redactor.
+      The _name_ of the Redactor setting configuration you want to use.
+      If you leave this blank, or specify a name that doesn't exist,
+      Statamic will use the first set of settings in the list.
 id: 25d8be49-2300-42ac-90e4-92df42fc2906
 ---
 ## Data Structure {#data-structure}
@@ -22,14 +21,32 @@ quote: |
   <blockquote>I signed up for Second Life about a year ago. Back then, my life was so great that I literally wanted a second one. Absolutely everything was the same... except I could fly.</blockquote><p>– Dwight Schrute</p>  
 ```
 
-This is fine, but keep it in mind if you're using it for your `content` field set to "markdown". Statamic parse the `content` as Markdown and any unintended text indentation will be converted to code blocks.
-
-[redactor-docs]: https://imperavi.com/assets/pdf/redactor-documentation-10.pdf
+This is fine, but keep it in mind if you're using it for your `content` field and are using a markdown file.
+Statamic automatically parses the `content` field as Markdown within `md` files.
 
 
 ## Redactor.js Configuration {#configuration}
 
-You are able to customize all of the Redactor options. You can [view the full list of settings in the Redactor documentation][redactor-docs]
+You are able to set any number of predefined Redactor setting configurations. We give you two out of the box, but of
+course you are free to modify those and add more.
+
+``` .language-yaml
+-
+  name: Standard
+  settings:
+    buttons: [formatting, bold, italic, unorderedlist, orderedlist, html]
+-
+  name: Basic
+  settings:
+    buttons: [bold, italic]
+```
+
+Each item has a name, which is what you will see when configuring your fieldtype, and the settings themselves.
+
+You can find these Redactor settings in `Configure > Settings > System` or within `site/settings/system.yaml`.
+
+The `settings` value should be a YAML representation of the options object that will get passed into the Redactor jQuery
+plugin. You are able to customize all of the Redactor options. You can [view the full list of settings in the Redactor documentation][redactor-docs].
 
 Any settings and options available to the plugin can be set here. For example, if the docs say to use the following configuration object:
 
@@ -43,12 +60,16 @@ $('textarea').redactor({
 You would translate to YAML like so:
 
 ``` .language-yaml
-settings:
-  formatting:
-    - p
-    - blockquote
-    - h2
-  minHeight: 300
+-
+  name: My Redactor Settings
+  settings:
+    formatting:
+      - p
+      - blockquote
+      - h2
+    minHeight: 300
 ```
 
 *Note: Function type options (eg. callbacks) are not supported.*
+
+[redactor-docs]: https://imperavi.com/assets/pdf/redactor-documentation-10.pdf