diff --git a/acknowledgements.md b/acknowledgements.md
index cb1cd3e6..19894764 100644
--- a/acknowledgements.md
+++ b/acknowledgements.md
@@ -2,6 +2,7 @@
id: acknowledgements
title: Acknowledgements
layout: single
+permalink: acknowledgements.html
---
We'd like to thank all of our contributors:
diff --git a/contributing/design-principles.md b/contributing/design-principles.md
index 223061cb..3027aa2a 100644
--- a/contributing/design-principles.md
+++ b/contributing/design-principles.md
@@ -2,7 +2,7 @@
id: design-principles
title: Design Principles
layout: contributing
-permalink: design-principles.html
+permalink: contributing/design-principles.html
---
After using React in a couple of applications, you might be interested in contributing to React. Before [diving into specifics](https://github.com/facebook/react/blob/master/CONTRIBUTING.md), we think it's important to establish a few design principles guiding our decisions about changes in React.
diff --git a/docs/01-why-react.ru-RU.md b/docs/01-why-react.ru-RU.md
index 9891840c..663552b7 100644
--- a/docs/01-why-react.ru-RU.md
+++ b/docs/01-why-react.ru-RU.md
@@ -1,7 +1,7 @@
---
id: why-react-ru-RU
title: Почему именно React?
-permalink: why-react-ru-RU.html
+permalink: docs/why-react-ru-RU.html
next: displaying-data-ru-RU.html
---
React — библиотека JavaScript для создания интерфейсов от команд Facebook и Instagram. Многие ассоциируют React с понятием **View** в паттерне **[MVC](https://ru.wikipedia.org/wiki/Model-View-Controller)**.
diff --git a/docs/01-why-react.zh-TW.md b/docs/01-why-react.zh-TW.md
index 6e8005e8..34cf9493 100644
--- a/docs/01-why-react.zh-TW.md
+++ b/docs/01-why-react.zh-TW.md
@@ -1,7 +1,7 @@
---
id: why-react-zh-TW
title: Why React?
-permalink: why-react-zh-TW.html
+permalink: docs/why-react-zh-TW.html
next: displaying-data.html
---
React是Facebook和Instagram用來建立使用者介面的JavaScript函式庫. 很多人認為React就是處理 **[MVC](https://en.wikipedia.org/wiki/Model%E2%80%93view%E2%80%93controller)**架構中 **V** 的部份.
diff --git a/docs/02-displaying-data.ru-RU.md b/docs/02-displaying-data.ru-RU.md
index ecdadd09..df4eb11e 100644
--- a/docs/02-displaying-data.ru-RU.md
+++ b/docs/02-displaying-data.ru-RU.md
@@ -1,7 +1,7 @@
---
id: displaying-data-ru-RU
title: Отображение данных
-permalink: displaying-data-ru-RU.html
+permalink: docs/displaying-data-ru-RU.html
prev: why-react-ru-RU.html
next: jsx-in-depth.html
---
diff --git a/docs/03-interactivity-and-dynamic-uis.ru-RU.md b/docs/03-interactivity-and-dynamic-uis.ru-RU.md
index f63425b1..def42b0b 100644
--- a/docs/03-interactivity-and-dynamic-uis.ru-RU.md
+++ b/docs/03-interactivity-and-dynamic-uis.ru-RU.md
@@ -1,7 +1,7 @@
---
id: interactivity-and-dynamic-uis-ru-RU
title: Интерактивные и динамические интерфейсы
-permalink: interactivity-and-dynamic-uis-ru-RU.html
+permalink: docs/interactivity-and-dynamic-uis-ru-RU.html
prev: jsx-gotchas.html
next: multiple-components.html
---
diff --git a/docs/error-decoder.md b/docs/error-decoder.md
index 76d13b39..8623bf5e 100644
--- a/docs/error-decoder.md
+++ b/docs/error-decoder.md
@@ -1,7 +1,7 @@
---
id: error-decoder
title: Error Decoder
-permalink: error-decoder.html
+permalink: docs/error-decoder.html
---
In the minified production build of React, we avoid sending down full error messages in order to reduce the number of bytes sent over the wire.
diff --git a/docs/getting-started.md b/docs/getting-started.md
index 39fbd0a5..10d0b761 100644
--- a/docs/getting-started.md
+++ b/docs/getting-started.md
@@ -1,6 +1,7 @@
---
id: getting-started
title: Getting Started
+permalink: docs/getting-started.html
next: tutorial.html
redirect_from: "docs/index.html"
---
diff --git a/docs/thinking-in-react.it-IT.md b/docs/thinking-in-react.it-IT.md
index 7cc96b61..3c65c63c 100644
--- a/docs/thinking-in-react.it-IT.md
+++ b/docs/thinking-in-react.it-IT.md
@@ -1,6 +1,7 @@
---
id: thinking-in-react-it-IT
title: Pensare in React
+permalink: docs/thinking-in-react-it-IT.html
prev: tutorial-it-IT.html
next: conferences-it-IT.html
redirect_from: 'blog/2013/11/05/thinking-in-react.html'
diff --git a/docs/thinking-in-react.ja-JP.md b/docs/thinking-in-react.ja-JP.md
index ee1768a7..0eb69e6c 100644
--- a/docs/thinking-in-react.ja-JP.md
+++ b/docs/thinking-in-react.ja-JP.md
@@ -1,6 +1,7 @@
---
id: thinking-in-react-ja-JP
title: Reactの考え方
+permalink: docs/thinking-in-react-ja-JP.html
prev: tutorial-ja-JP.html
next: conferences.html
redirect_from: 'blog/2013/11/05/thinking-in-react.html'
diff --git a/docs/thinking-in-react.md b/docs/thinking-in-react.md
index 811bfc99..187ba37c 100644
--- a/docs/thinking-in-react.md
+++ b/docs/thinking-in-react.md
@@ -1,6 +1,7 @@
---
id: thinking-in-react
title: Thinking in React
+permalink: docs/thinking-in-react.html
prev: tutorial.html
next: conferences.html
redirect_from: 'blog/2013/11/05/thinking-in-react.html'
diff --git a/docs/thinking-in-react.zh-CN.md b/docs/thinking-in-react.zh-CN.md
index 574983d0..59f72257 100644
--- a/docs/thinking-in-react.zh-CN.md
+++ b/docs/thinking-in-react.zh-CN.md
@@ -1,7 +1,7 @@
---
id: thinking-in-react-zh-CN
title: React 编程思想
-permalink: thinking-in-react-zh-CN.html
+permalink: docs/thinking-in-react-zh-CN.html
prev: tutorial-zh-CN.html
next: conferences-zh-CN.html
redirect_from: 'blog/2013/11/05/thinking-in-react.html'
diff --git a/docs/tutorial.it-IT.md b/docs/tutorial.it-IT.md
index 860da401..9eec9964 100755
--- a/docs/tutorial.it-IT.md
+++ b/docs/tutorial.it-IT.md
@@ -1,6 +1,7 @@
---
id: tutorial-it-IT
title: Tutorial
+permalink: docs/tutorial-it-IT.html
prev: getting-started-it-IT.html
next: thinking-in-react-it-IT.html
---
diff --git a/docs/tutorial.md b/docs/tutorial.md
index 1ec10536..f6f96041 100755
--- a/docs/tutorial.md
+++ b/docs/tutorial.md
@@ -1,6 +1,7 @@
---
id: tutorial
title: Tutorial
+permalink: docs/tutorial.html
prev: getting-started.html
next: thinking-in-react.html
---
diff --git a/docs/tutorial.zh-CN.md b/docs/tutorial.zh-CN.md
index 02c108cc..0b9e94a5 100755
--- a/docs/tutorial.zh-CN.md
+++ b/docs/tutorial.zh-CN.md
@@ -1,7 +1,7 @@
---
id: tutorial-zh-CN
title: 教程
-permalink: tutorial-zh-CN.html
+permalink: docs/tutorial-zh-CN.html
prev: getting-started-zh-CN.html
next: thinking-in-react-zh-CN.html
---
diff --git a/downloads.md b/downloads.md
index 7a89c59d..55edc964 100644
--- a/downloads.md
+++ b/downloads.md
@@ -2,6 +2,7 @@
id: downloads
title: Downloads
layout: single
+permalink: downloads.html
---
Download the starter kit to get everything you need to
[get started with React](/react/docs/getting-started.html). The starter kit includes React and some simple example apps.
diff --git a/feed.xml b/feed.xml
index ddd764e3..0d9c1e65 100644
--- a/feed.xml
+++ b/feed.xml
@@ -1,5 +1,4 @@
---
-layout: none
---
diff --git a/jsx-compiler.md b/jsx-compiler.md
index bcfa6430..85e9775f 100644
--- a/jsx-compiler.md
+++ b/jsx-compiler.md
@@ -1,6 +1,7 @@
---
layout: single
title: JSX Compiler Service
+permalink: jsx-compiler.html
id: jsx-compiler
---
diff --git a/support.md b/support.md
index 49154559..88fe106c 100644
--- a/support.md
+++ b/support.md
@@ -2,6 +2,7 @@
title: Need help?
layout: single
id: support
+permalink: support.html
---
**React** is worked on full-time by Facebook's product infrastructure and Instagram's user interface engineering teams. They're often around and available for questions.
diff --git a/warnings/legacy-factories.md b/warnings/legacy-factories.md
index 3a240a1b..25fc5aaa 100644
--- a/warnings/legacy-factories.md
+++ b/warnings/legacy-factories.md
@@ -1,6 +1,7 @@
---
title: React Element Factories and JSX Warning
layout: single
+permalink: warnings/legacy-factories.html
---
You probably came here because your code is calling your component as a plain function call. This is now deprecated:
diff --git a/warnings/refs-must-have-owner.md b/warnings/refs-must-have-owner.md
index 9d3bd00d..471a0699 100644
--- a/warnings/refs-must-have-owner.md
+++ b/warnings/refs-must-have-owner.md
@@ -1,6 +1,7 @@
---
title: Refs Must Have Owner Warning
layout: single
+permalink: warnings/refs-must-have-owner.html
---
You are probably here because you got the following error messages:
diff --git a/warnings/special-props.md b/warnings/special-props.md
index d0260cc3..cdd6b265 100644
--- a/warnings/special-props.md
+++ b/warnings/special-props.md
@@ -1,6 +1,7 @@
---
title: Special Props Warning
layout: single
+permalink: warnings/special-props.html
---
Most props on a JSX element are passed on to the component, however, there are two special props (`ref` and `key`) which are used by React, and are thus not forwarded to the component.
diff --git a/warnings/unknown-prop.md b/warnings/unknown-prop.md
index 959fa94f..9f030a82 100644
--- a/warnings/unknown-prop.md
+++ b/warnings/unknown-prop.md
@@ -1,6 +1,7 @@
---
title: Unknown Prop Warning
layout: single
+permalink: warnings/unknown-prop.html
---
The unknown-prop warning will fire if you attempt to render a DOM element with a prop that is not recognized by React as a legal DOM attribute/property. You should ensure that your DOM elements do not have spurious props floating around.