diff --git a/docs/content/doc/front-matter.md b/docs/content/doc/front-matter.md
index 0fb03b443..566fb1fba 100644
--- a/docs/content/doc/front-matter.md
+++ b/docs/content/doc/front-matter.md
@@ -4,8 +4,8 @@ date = "2013-07-01"
+++
The front matter is one of the features that gives Hugo it's strength. It enables
-you to include the meta data of the content right with it. Hugo supports a few
-different formats each with their own identifying tokens.
+you to include the meta data of the content right with it. Hugo supports a few
+different formats each with their own identifying tokens.
Supported formats:
**YAML**, identified by '\-\-\-'.
@@ -24,7 +24,7 @@ Supported formats:
- "VIM"
slug: "spf13-vim-3-0-release-and-new-website"
---
- Content of the file goes Here
+ Content of the file goes Here
### TOML Example
@@ -39,7 +39,7 @@ Supported formats:
]
slug = "spf13-vim-3-0-release-and-new-website"
+++
- Content of the file goes Here
+ Content of the file goes Here
### JSON Example
@@ -54,7 +54,7 @@ Supported formats:
],
"slug": "spf13-vim-3-0-release-and-new-website",
}
- Content of the file goes Here
+ Content of the file goes Here
### Variables
@@ -71,6 +71,7 @@ any variable they want to. These will be placed into the `.Params` variable avai
#### Optional
+**redirect** Mark the post as a redirect post
**draft** If true the content will not be rendered unless `hugo` is called with -d
**type** The type of the content (will be derived from the directory automatically if unset).
**markup** (Experimental) Specify "rst" for reStructuredText (requires
diff --git a/docs/content/doc/redirects.md b/docs/content/doc/redirects.md
new file mode 100644
index 000000000..74b742d4b
--- /dev/null
+++ b/docs/content/doc/redirects.md
@@ -0,0 +1,37 @@
+---
+title: "Redirects"
+Pubdate: "2013-07-09"
+---
+
+For people migrating existing published content to Hugo theres a good chance
+you need a mechanism to handle redirecting old urls.
+
+Luckily, this can be handled easily in a couple of easy steps.
+
+1. Create a special post for the redirect and mark the file as a `redirect`
+ file in the front matter. Here is an example
+ `content/redirects/my-awesome-blog-post.md` :
+
+ ```markdown
+ ---
+ redirect: true
+ slug: /my-awesome-blog-post/
+ url: /docs/redirects/
+ ---
+```
+
+2. Set the redirect template `layouts/redirects/single.html`:
+
+ ```html
+
+
+