rearrange all the things.

Author: jackmcdade

content/collections/tags/assets.md

@@ -3,6 +3,7 @@ id: 5b748a3f-be0e-41c1-8877-73f6b7ee1d0a
 title: Assets
 overview: >
     Used to retrieve Assets data from the [Asset Fieldtype](/docs/fieldtypes/assets). Your site's Assets are managed and stored independently of your pages and entries and have a joined relationship through their `id`. [Learn more about Assets](/guides/assets).
+description: Fetch image/file Assets from an Assets field.
 variables:
   -
     name: id

content/collections/tags/cache.md

@@ -7,6 +7,7 @@ parameters:
     name: scope
     type: 'string *site*'
     description: 'Sets the cache scope. You have your choice of the default `site` or `page`.'
+description: Cache a template chunk for performance.
 id: 1d0d2d1f-734b-4360-af7a-6792bf670bc7
 ---
 ## Usage {#usage}

content/collections/tags/collection-next.md

@@ -1,8 +1,6 @@
 ---
 title: Next
-overview: >
-  Iterate over the next entries that would
-  show up in the listing.
+overview:  Grab the next entries relative to current entry in a Collection.
 parameters:
   -
     name: in|collection

content/collections/tags/collection-previous.md

@@ -1,8 +1,6 @@
 ---
 title: Previous
-overview: >
-  Iterate over the previous entries that
-  would show up in the listing.
+overview: Grab the previous entries relative to current entry in a Collection.
 id: 741cf972-c0bd-4e3c-81e2-8cc8bea60737
 ---
 This Tag functions the same way as the [`collection:next`](/docs/tags/collection-next) tag, but in the opposite direction.

content/collections/tags/collection.md

@@ -2,6 +2,7 @@
 title: Collection
 is_parent_tag: true
 overview: Entries are grouped into Collections and connected to this tag to provide you means to fetch, sort, filter, and arrange them in various ways. A Collection might contain blog posts, products, or even a pile of terrible knock-knock jokes. We don't judge, and neither does the Collection Tag.
+description: Grab and filter the entries in a specified Collection.
 parameters:
   -
     name: from|folder|use

content/collections/tags/entries.md

@@ -2,7 +2,7 @@
 title: Entries
 id: 45e7802d-2399-4a60-9cf8-35441efa9aab
 is_parent_tag: true
-overview: Iterate over entries in a collection.
+overview: Iterate over entries in a Collection.
 parameters:
   -
     name: url

content/collections/tags/form-create.md

@@ -2,7 +2,7 @@
 title: Create
 id: aa96fcf1-510c-404b-9b63-cea8942e1bf8
 overview: >
-  This Tag will generate a `<form>` to allow your users to create submissions into a particular Form.
+  Generate necessary `<form>` markup to accept form submissions.
 parameters:
   -
     name: formset|in

content/collections/tags/form-errors.md

@@ -4,6 +4,7 @@ id: eff214d5-cd61-4318-b351-14f765bbe4fc
 overview: >
   When a form submission encounters a validation error, this Tag allows
   you to show your user where everything went south.
+description: Display form errors.
 parameters:
   -
     name: formset|in

content/collections/tags/form-set.md

@@ -1,8 +1,7 @@
 ---
 title: Formset
 id: 0b9590a7-f8b3-4a11-92b5-60d6d43cf869
-overview: >
-  A shortcut tag to allow all child Form tags to inherit the formset.
+overview: Wrap a group of form tags to set them all to the same formset.
 parameters:
   -
     name: in|is|formset

content/collections/tags/form-submission.md

@@ -1,8 +1,7 @@
 ---
 title: Submission
 id: 8720d9ed-3a5f-4c60-af74-7b82933146a2
-overview: >
-  Allows you to output data from the form that was just successfully submitted.
+overview: Display data immediately following a successful submission.
 parameters:
   -
     name: formset|in

content/collections/tags/form-submissions.md

@@ -1,8 +1,7 @@
 ---
 title: Submissions
 id: afa2740e-2cf7-4ada-a92e-4fc92e827351
-overview: >
-  Allows you to iterate over form submissions.
+overview: Iterate over and display data from form submissions.
 parameters:
   -
     name: formset|in

content/collections/tags/form-success.md

@@ -1,7 +1,7 @@
 ---
 title: Success
 id: e7430255-6237-4cc8-96c2-e8338758851f
-overview: A boolean tag used to check if a form submission was successful.
+overview: Boolean if a form submission was successful.
 parameters:
   -
     name: formset|in

content/collections/tags/form.md

@@ -1,7 +1,7 @@
 ---
 title: Form
 is_parent_tag: true
-overview: The Form Tags allow you to create and display submissions grouped into different sections.
+overview: Create and display submissions grouped into different sections.
 id: e4f4f91e-a442-4e15-9e16-3b9880a25522
 ---
 For information on how to best use these tags, visit the [Trail Guide](/guides/forms).

content/collections/tags/get_content.md

@@ -4,6 +4,7 @@ id: a33dd9d3-f2f0-4114-b19d-1126361c327e
 parse_content: false
 overview: |
   With nothing but a URI, or list of URIs, you can fetch all available data regardless of the content type. It is a friend to pages, entries, and taxonomies alike.
+description: Fetch data by one or more URLs regardless of content type.
 parameters:
   -
     name: from

content/collections/tags/get_files.md

@@ -1,6 +1,6 @@
 ---
 title: Get Value
-overview: Get an associative array value and loop through it, optionally applying filters along the way.
+overview: Grab an associative array value so you can filter and loop through it.
 parameters:
   -
     name: field

content/collections/tags/get_value.md

@@ -1,8 +1,6 @@
 ---
 title: Glide
-overview: >
-  Create on-the-fly image asset transforms
-  using the fantastic Glide package.
+overview: Manipulate Asset images on the fly.
 parameters:
   -
     name: src

content/collections/tags/glide.md

@@ -1,47 +1,38 @@
 overview: >
-  Breadcrumbs are a common form of site
-  navigation, usually used in situations
-  where you have a lot of hierarchal
-  content the user must navigate and you
-  want to make sure they know where they
-  are. They consist of a list of links,
-  separated by a divider, leading you from
-  the current page back up to the home
-  page.
+  Breadcrumbs are a common form of site navigation, usually used in situations where you have a lot of hierarchal content the user must navigate and you want to make sure they know where they are. They consist of a list of links, separated by a divider, leading you from the current page back up to the home page.
+description: Display breadcrumb-style navigation links to your current page.
 parameters:
-  - 
+  -
     name: 'url '
     type: string
     description: >
-      The starting point for your breadcrumbs
-      is usually the current page, but can be
-      overriden behavior if necessary.
-  - 
+      Defaults to your current page, but can be set to anywhere if necessary.
+  -
     name: include_home
     type: 'boolean *TRUE*'
     description: >
       You can choose to turn off the home page
       in the breadcrumbs, opting to start the
       crumbs from the first level nav item.
-  - 
+  -
     name: reverse
     type: 'boolean *TRUE*'
     description: Reverse the output of the breadcrumbs.
-  - 
+  -
     name: trim
     type: 'boolean *TRUE*'
     description: >
       Trim the whitespace from each iteration
       of the loop.
 variables:
-  - 
+  -
     name: is_current
     type: boolean
     description: >
       Whether the current page is the URL
       being viewed. Useful for outputting
       active states.
-  - 
+  -
     name: page data
     type: mixed
     description: >

content/collections/tags/nav-breadcrumbs.md

@@ -1,5 +1,5 @@
 ---
-overview: 'Get the number of pages in a tree.  '
+overview: Return the number of pages in a Nav tree.
 title: Count
 id: 684e2406-1d15-4f80-b72a-defc46c8d7c8
 ---

content/collections/tags/nav-count.md

@@ -1,9 +1,7 @@
 ---
-overview: >
-  Lets you test whether a set of
-  parameters will result in a page tree.
+overview: Test whether a set of parameters will result in a page tree.
 title: Exists
 id: b0275e02-2a64-4233-a335-1da161f23216
 ---
 It's useful for checking whether or not a certain tree should be displayed.  
-It uses the same parameters to the `nav` tag.
+It uses the same parameters to the `nav` tag.

content/collections/tags/nav-exists.md

@@ -1,14 +1,8 @@
 ---
-overview: >
-  The nav tags are designed to help your
-  users navigate through your hierarchy of
-  pages. They work together to allow you
-  to easily traverse your content upways
-  and downways, sideways, slantways,
-  longways, backways, squareways,
-  frontways, and any other ways that you
-  can think of.
 title: Nav
+overview: >
+  The nav tags are designed to help your users navigate through your hierarchy of pages. They work together to allow you to easily traverse your content upways and downways, sideways, slantways, longways, backways, squareways, frontways, and any other ways that you can think of.
+description: Create site navigation based off your Pages structure.
 id: ed746608-87f9-448f-bf57-051da132fef7
 is_parent_tag: true
 parameters:

content/collections/tags/nav.md

@@ -4,6 +4,7 @@ id: 161f6255-465d-41bd-8028-d6aba01cebbf
 parse_content: false
 overview: |
   Obfuscation is a method of encoding content so that the source code is hard or impossible to understand. This is generally used on email addresses to prevent spambots from recognizing it as an email address and keeping you safe from unwanted emails.
+description: Obfuscate content (usually email addresses) to prevent screenscraping.
 ---
 ## Usage {#usage}
 

content/collections/tags/obfuscate.md

@@ -1,8 +1,6 @@
 ---
 title: Old
-overview: >
-  Display form input values from the
-  previous request.
+overview: Display any form input values from the previous request.
 id: 90c44fc3-a6e4-434d-ac1f-1185c382cc5c
 ---
 In Tags with form elements – for example, `{{ user:login_form }}` – you may encounter validation errors that will require you to resubmit your the form.

content/collections/tags/old.md

@@ -1,8 +1,6 @@
 ---
 title: Listing
-overview: >
-  An alias of the `pages` tag, for
-  backwards compatibility.
+overview: An alias of the `pages` tag, for backwards compatibility.
 id: 4b87448a-0bbd-46be-87ee-a194ea0ea14d
 ---
 ```

content/collections/tags/pages-listing.md

@@ -1,8 +1,6 @@
 ---
 title: Next
-overview: >
-  Iterate over the next entries that would
-  show up in the listing.
+overview: Grab the next Pages relative to your current Page.
 parameters:
   -
     name: from|folder|url

content/collections/tags/pages-next.md

@@ -1,8 +1,6 @@
 ---
 title: Previous
-overview: >
-  Iterate over the previous pages that
-  would show up in the list.
+overview: Grab the previous Pages relative to your current Page.
 id: 1172608e-0e75-487a-8cd6-872746542550
 ---
 This Tag functions the same way as the [`pages:next`](/docs/tags/pages-next) tag, but in the opposite direction.

content/collections/tags/pages-previous.md

@@ -1,7 +1,7 @@
 ---
 title: Pages
 is_parent_tag: true
-overview: Iterate over child pages.
+overview: Grab and iterate over child pages.
 parameters:
   -
     name: url

content/collections/tags/pages.md

@@ -1,6 +1,6 @@
 ---
 title: Parent
-overview: "Retrieve page variables for the current page's parent page."
+overview: Grab the current page's parent's page data. You follow that?
 parameters:
   -
     name: field

content/collections/tags/parent.md

@@ -1,6 +1,6 @@
 ---
 title: Partial
-overview: "Display a partial from within the currently-selected theme's partials folder."
+overview: Render a partial template.
 parameters:
   -
     name: partial

content/collections/tags/partial.md

@@ -1,8 +1,6 @@
 ---
 title: Path
-overview: >
-  Contextualizes a path with the current
-  site root.
+overview: Prepend a URL/string with the current site root.
 parameters:
   -
     name: src

content/collections/tags/path.md

@@ -1,6 +1,6 @@
 ---
 title: Redirect
-overview: Redirects the page to another page.
+overview: Redirect to another page.
 parameters:
   -
     name: url

content/collections/tags/redirect.md

@@ -1,5 +1,6 @@
 ---
 title: Relate
+description: Grab data through relationships.
 overview: |
   Relate allows you to fetch content from a relationship using a very simple tag syntax. Relate tags can even be nested inside each other.
 

content/collections/tags/relate.md

@@ -1,7 +1,7 @@
 ---
 title: Routes
 is_parent_tag: true
-overview: Loop through your Template Routes and access any inline data with this helper tag.
+overview: Loop through your Template Routes and access inline data.
 variables:
   -
     name: url

content/collections/tags/routes.md

@@ -1,5 +1,6 @@
 ---
 title: Form
+description: How to create a search form.
 id: 1ab4aca4-1add-4b41-b40c-4f3e8170fd98
 ---
 There's no special search form tag that you need to use. Simply create a form that performs a GET request to where your results will be listed.
@@ -11,4 +12,4 @@ There's no special search form tag that you need to use. Simply create a form th
 </form>
 ```
 
-Assuming that the `{{ search:results }}` tag is on `/search-results`, and that you searched for `majestic stags`, submitting this form will take you to `/search-results?q=majestic+stags`.
+Assuming that the `{{ search:results }}` tag is on `/search-results`, and that you searched for `majestic stags`, submitting this form will take you to `/search-results?q=majestic+stags`.