Merge branch 'stkent-patch-1'

* stkent-patch-1:
  Restructure excerpt_separator documentation for clarity

site/_docs/posts.md

@@ -166,18 +166,9 @@ following if you'd prefer:
 {% endhighlight %}
 
 If you don't like the automatically-generated post excerpt, it can be
-overridden by adding `excerpt` to your post's YAML Front Matter. Completely
-disable it by setting your `excerpt_separator` to `""`.
-
-Also, as with any output generated by Liquid tags, you can pass the
-`| strip_html` flag to remove any html tags in the output. This is particularly
-helpful if you wish to output a post excerpt as a `meta="description"` tag
-within the post `head`, or anywhere else having html tags along with the
-content is not desirable.
-
-Additionally you are able to specify per-post `excerpt_separator` value if it
-is required just only the the selected post. Just specify the
-`excerpt_separator` with the same way as `excerpt` in the post's YAML head:
+explicitly overridden by adding an `excerpt` value to your post's YAML
+Front Matter. Alternatively, you can choose to define a custom
+`excerpt_separator` in the post's YAML front matter:
 
 {% highlight text %}
 ---
@@ -189,6 +180,14 @@ Excerpt
 Out-of-excerpt
 {% endhighlight %}
 
+Completely disable excerpts by setting your `excerpt_separator` to `""`.
+
+Also, as with any output generated by Liquid tags, you can pass the
+`| strip_html` filter to remove any html tags in the output. This is
+particularly helpful if you wish to output a post excerpt as a
+`meta="description"` tag within the post `head`, or anywhere else having
+html tags along with the content is not desirable.
+
 ## Highlighting code snippets
 
 Jekyll also has built-in support for syntax highlighting of code snippets using