diff --git a/Gemfile b/Gemfile
index 4f4991e3b..f144584ef 100644
--- a/Gemfile
+++ b/Gemfile
@@ -3,11 +3,12 @@ source 'https://rubygems.org'
 gem 'rake'
 
 # jekyll, which builds it all
-# 2.0 includes sass processing
-gem 'jekyll', '~>2.0'
+# 3.0 includes sass processing
+gem 'jekyll', '~>3.1'
 
-# Auto redirect pages
+# Jekyll extensions
 gem 'jekyll-redirect-from'
+gem 'jekyll-paginate'
 
 # JSON
 gem 'json'
@@ -17,3 +18,12 @@ gem 'rb-fsevent'
 
 # For markdown header cleanup
 gem 'sanitize', '~>2.0'
+
+# Markdown
+gem 'redcarpet'
+
+# Syntax highlighting
+gem 'pygments.rb'
+
+# Avoid having to poll for changes on Windows
+gem 'wdm', '>= 0.1.0' if Gem.win_platform?
\ No newline at end of file
diff --git a/Gemfile.lock b/Gemfile.lock
index 89a0f264a..e2d319117 100644
--- a/Gemfile.lock
+++ b/Gemfile.lock
@@ -1,85 +1,69 @@
 GEM
   remote: https://rubygems.org/
   specs:
-    blankslate (2.1.2.4)
-    celluloid (0.15.2)
-      timers (~> 1.1.0)
-    classifier (1.3.4)
-      fast-stemmer (>= 1.0.0)
-    coffee-script (2.3.0)
-      coffee-script-source
-      execjs
-    coffee-script-source (1.7.1)
     colorator (0.1)
-    execjs (2.2.1)
-    fast-stemmer (1.0.2)
-    ffi (1.9.3)
-    jekyll (2.2.0)
-      classifier (~> 1.3)
+    ffi (1.9.10)
+    ffi (1.9.10-x64-mingw32)
+    jekyll (3.1.3)
       colorator (~> 0.1)
-      jekyll-coffeescript (~> 1.0)
-      jekyll-gist (~> 1.0)
-      jekyll-paginate (~> 1.0)
       jekyll-sass-converter (~> 1.0)
-      jekyll-watch (~> 1.0)
+      jekyll-watch (~> 1.1)
       kramdown (~> 1.3)
-      liquid (~> 2.6.1)
+      liquid (~> 3.0)
       mercenary (~> 0.3.3)
-      pygments.rb (~> 0.6.0)
-      redcarpet (~> 3.1)
+      rouge (~> 1.7)
       safe_yaml (~> 1.0)
-      toml (~> 0.1.0)
-    jekyll-coffeescript (1.0.0)
-      coffee-script (~> 2.2)
-    jekyll-gist (1.1.0)
-    jekyll-paginate (1.0.0)
-    jekyll-redirect-from (0.5.0)
-      jekyll (~> 2.0)
-    jekyll-sass-converter (1.2.0)
-      sass (~> 3.2)
-    jekyll-watch (1.1.0)
-      listen (~> 2.7)
-    json (1.8.1)
-    kramdown (1.4.1)
-    liquid (2.6.1)
-    listen (2.7.9)
-      celluloid (>= 0.15.2)
+    jekyll-paginate (1.1.0)
+    jekyll-redirect-from (0.10.0)
+      jekyll (>= 2.0)
+    jekyll-sass-converter (1.4.0)
+      sass (~> 3.4)
+    jekyll-watch (1.3.1)
+      listen (~> 3.0)
+    json (1.8.3)
+    kramdown (1.10.0)
+    liquid (3.0.6)
+    listen (3.1.1)
       rb-fsevent (>= 0.9.3)
-      rb-inotify (>= 0.9)
-    mercenary (0.3.4)
-    mini_portile (0.6.0)
-    nokogiri (1.6.3.1)
-      mini_portile (= 0.6.0)
-    parslet (1.5.0)
-      blankslate (~> 2.0)
-    posix-spawn (0.3.9)
-    pygments.rb (0.6.0)
+      rb-inotify (>= 0.9.7)
+    mercenary (0.3.6)
+    mini_portile2 (2.0.0)
+    nokogiri (1.6.7.2)
+      mini_portile2 (~> 2.0.0.rc2)
+    nokogiri (1.6.7.2-x64-mingw32)
+      mini_portile2 (~> 2.0.0.rc2)
+    posix-spawn (0.3.11)
+    pygments.rb (0.6.3)
       posix-spawn (~> 0.3.6)
-      yajl-ruby (~> 1.1.0)
-    rake (10.3.2)
-    rb-fsevent (0.9.4)
-    rb-inotify (0.9.5)
+      yajl-ruby (~> 1.2.0)
+    rake (11.1.2)
+    rb-fsevent (0.9.7)
+    rb-inotify (0.9.7)
       ffi (>= 0.5.0)
-    redcarpet (3.1.2)
+    redcarpet (3.3.4)
+    rouge (1.10.1)
     safe_yaml (1.0.4)
-    sanitize (2.0.6)
+    sanitize (2.1.0)
       nokogiri (>= 1.4.4)
-    sass (3.3.14)
-    timers (1.1.0)
-    toml (0.1.1)
-      parslet (~> 1.5.0)
-    yajl-ruby (1.1.0)
+    sass (3.4.22)
+    wdm (0.1.1)
+    yajl-ruby (1.2.1)
 
 PLATFORMS
   ruby
+  x64-mingw32
 
 DEPENDENCIES
-  jekyll (~> 2.0)
+  jekyll (~> 3.1)
+  jekyll-paginate
   jekyll-redirect-from
   json
+  pygments.rb
   rake
   rb-fsevent
+  redcarpet
   sanitize (~> 2.0)
+  wdm (>= 0.1.0)
 
 BUNDLED WITH
-   1.10.1
+   1.11.2
diff --git a/_config.yml b/_config.yml
index a4bdbce13..2a46105aa 100644
--- a/_config.yml
+++ b/_config.yml
@@ -5,19 +5,18 @@ url: https://facebook.github.io
 baseurl: "/react"
 permalink: "/blog/:year/:month/:day/:title.html"
 paginate_path: "/blog/page:num/"
-relative_permalinks: true
 paginate: 5
 timezone: America/Los_Angeles
 highlighter: pygments
 defaults:
 - scope:
     path: ''
-    type: post
+    type: posts
   values:
     layout: post
 - scope:
     path: docs
-    type: page
+    type: pages
   values:
     layout: docs
 exclude:
@@ -36,6 +35,7 @@ sass:
   sass_dir: _css
 gems:
 - jekyll-redirect-from
+- jekyll-paginate
 react_version: 15.2.1
 react_hashes:
   dev: g2900ZIpFKhyIsz+bnx4YDEfAISugYRU58ljeAgI8TZ0A0AkRLGUCN7OmjF16Cj+
diff --git a/_layouts/default.html b/_layouts/default.html
index d42b8b157..82659d8f3 100644
--- a/_layouts/default.html
+++ b/_layouts/default.html
@@ -50,10 +50,10 @@
           React
         </a>
         <ul class="nav-site nav-site-internal">
-          <li><a href="/react/docs/getting-started.html"{% if page.sectionid == 'docs' or page.sectionid == 'tips' or page.sectionid == 'contributing' %} class="active"{% endif %}>Docs</a></li>
+          <li><a href="/react/docs/getting-started.html"{% if layout.sectionid == 'docs' or layout.sectionid == 'tips' or layout.sectionid == 'contributing' %} class="active"{% endif %}>Docs</a></li>
           <li><a href="/react/support.html"{% if page.id == 'support' %} class="active"{% endif %}>Support</a></li>
           <li><a href="/react/downloads.html"{% if page.id == 'downloads' %} class="active"{% endif %}>Download</a></li>
-          <li><a href="/react/blog/"{% if page.sectionid == 'blog' %} class="active"{% endif %}>Blog</a></li>
+          <li><a href="/react/blog/"{% if layout.sectionid == 'blog' %} class="active"{% endif %}>Blog</a></li>
           <li>
             <input id="algolia-doc-search" type="text" placeholder="Search docs..." />
           </li>
diff --git a/_plugins/authors.rb b/_plugins/authors.rb
index e3ce378ce..956ee7fd3 100644
--- a/_plugins/authors.rb
+++ b/_plugins/authors.rb
@@ -6,7 +6,7 @@
 module Authors
   class Generator < Jekyll::Generator
     def generate(site)
-      site.posts.each do |post|
+      site.posts.docs.each do |post|
         authors = []
         if post['author'].kind_of?(Array)
           for author in post['author']
diff --git a/docs/01-why-react.de-DE.md b/docs/01-why-react.de-DE.md
index 93bd91217..4b14259e0 100644
--- a/docs/01-why-react.de-DE.md
+++ b/docs/01-why-react.de-DE.md
@@ -1,7 +1,7 @@
 ---
 id: why-react-de-DE
 title: Warum React?
-permalink: why-react-de-DE.html
+permalink: docs/why-react-de-DE.html
 ---
 React ist eine JavaScript-Bibliothek von Facebook und Instagram für Benutzeroberflächen. Man kann sich React als das **V** in **[MVC](https://de.wikipedia.org/wiki/Model_View_Controller)** vorstellen.
 
diff --git a/docs/01-why-react.it-IT.md b/docs/01-why-react.it-IT.md
index 2fc2f5c0d..dc93d909f 100644
--- a/docs/01-why-react.it-IT.md
+++ b/docs/01-why-react.it-IT.md
@@ -1,7 +1,7 @@
 ---
 id: why-react-it-IT
 title: Perché React?
-permalink: why-react-it-IT.html
+permalink: docs/why-react-it-IT.html
 next: displaying-data-it-IT.html
 ---
 React è una libreria JavaScript per creare interfacce utente scritta da Facebook e Instagram. A molti piace pensare a React come alla **V** di **[MVC](https://it.wikipedia.org/wiki/Model-View-Controller)**.
diff --git a/docs/01-why-react.ja-JP.md b/docs/01-why-react.ja-JP.md
index e9f37b29a..9d1e9be17 100644
--- a/docs/01-why-react.ja-JP.md
+++ b/docs/01-why-react.ja-JP.md
@@ -1,7 +1,7 @@
 ---
 id: why-react-ja-JP
 title: なぜReactを使うのでしょうか？
-permalink: why-react-ja-JP.html
+permalink: docs/why-react-ja-JP.html
 next: displaying-data-ja-JP.html
 
 ---
diff --git a/docs/01-why-react.ko-KR.md b/docs/01-why-react.ko-KR.md
index 93b41993f..af257d681 100644
--- a/docs/01-why-react.ko-KR.md
+++ b/docs/01-why-react.ko-KR.md
@@ -1,7 +1,7 @@
 ---
 id: why-react-ko-KR
 title: 왜 React인가?
-permalink: why-react-ko-KR.html
+permalink: docs/why-react-ko-KR.html
 next: displaying-data-ko-KR.html
 ---
 
diff --git a/docs/01-why-react.md b/docs/01-why-react.md
index fd94b2f04..f39893f58 100644
--- a/docs/01-why-react.md
+++ b/docs/01-why-react.md
@@ -1,7 +1,7 @@
 ---
 id: why-react
 title: Why React?
-permalink: why-react.html
+permalink: docs/why-react.html
 next: displaying-data.html
 ---
 React is a JavaScript library for creating user interfaces by Facebook and Instagram. Many people choose to think of React as the **V** in **[MVC](https://en.wikipedia.org/wiki/Model%E2%80%93view%E2%80%93controller)**.
diff --git a/docs/01-why-react.zh-CN.md b/docs/01-why-react.zh-CN.md
index ca1ae0a0f..74514f295 100644
--- a/docs/01-why-react.zh-CN.md
+++ b/docs/01-why-react.zh-CN.md
@@ -1,7 +1,7 @@
 ---
 id: why-react-zh-CN
 title: 为什么使用 React?
-permalink: why-react-zh-CN.html
+permalink: docs/why-react-zh-CN.html
 next: displaying-data-zh-CN.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.it-IT.md b/docs/02-displaying-data.it-IT.md
index 368e97438..087fb8261 100644
--- a/docs/02-displaying-data.it-IT.md
+++ b/docs/02-displaying-data.it-IT.md
@@ -1,7 +1,7 @@
 ---
 id: displaying-data-it-IT
 title: Visualizzare Dati
-permalink: displaying-data-it-IT.html
+permalink: docs/displaying-data-it-IT.html
 prev: why-react-it-IT.html
 next: jsx-in-depth-it-IT.html
 ---
diff --git a/docs/02-displaying-data.ja-JP.md b/docs/02-displaying-data.ja-JP.md
index 415d38fa0..5e3ee8f73 100644
--- a/docs/02-displaying-data.ja-JP.md
+++ b/docs/02-displaying-data.ja-JP.md
@@ -1,7 +1,7 @@
 ---
 id: displaying-data-ja-JP
 title: データを表示する
-permalink: displaying-data-ja-JP.html
+permalink: docs/displaying-data-ja-JP.html
 prev: why-react-ja-JP.html
 next: jsx-in-depth-ja-JP.html
 
diff --git a/docs/02-displaying-data.ko-KR.md b/docs/02-displaying-data.ko-KR.md
index 79d151aca..fd14b4f70 100644
--- a/docs/02-displaying-data.ko-KR.md
+++ b/docs/02-displaying-data.ko-KR.md
@@ -1,7 +1,7 @@
 ---
 id: displaying-data-ko-KR
 title: 데이터를 표시하기
-permalink: displaying-data-ko-KR.html
+permalink: docs/displaying-data-ko-KR.html
 prev: why-react-ko-KR.html
 next: jsx-in-depth-ko-KR.html
 ---
diff --git a/docs/02-displaying-data.md b/docs/02-displaying-data.md
index c2ccafe34..7276bf32f 100644
--- a/docs/02-displaying-data.md
+++ b/docs/02-displaying-data.md
@@ -1,7 +1,7 @@
 ---
 id: displaying-data
 title: Displaying Data
-permalink: displaying-data.html
+permalink: docs/displaying-data.html
 prev: why-react.html
 next: jsx-in-depth.html
 ---
diff --git a/docs/02-displaying-data.zh-CN.md b/docs/02-displaying-data.zh-CN.md
index d1e1fdbf8..9bb7e66c0 100644
--- a/docs/02-displaying-data.zh-CN.md
+++ b/docs/02-displaying-data.zh-CN.md
@@ -1,7 +1,7 @@
 ---
 id: displaying-data-zh-CN
 title: 显示数据
-permalink: displaying-data-zh-CN.html
+permalink: docs/displaying-data-zh-CN.html
 prev: why-react-zh-CN.html
 next: jsx-in-depth-zh-CN.html
 ---
diff --git a/docs/02.1-jsx-in-depth.it-IT.md b/docs/02.1-jsx-in-depth.it-IT.md
index a0e401467..67eac1644 100644
--- a/docs/02.1-jsx-in-depth.it-IT.md
+++ b/docs/02.1-jsx-in-depth.it-IT.md
@@ -1,7 +1,7 @@
 ---
 id: jsx-in-depth-it-IT
 title: JSX in Profondità
-permalink: jsx-in-depth-it-IT.html
+permalink: docs/jsx-in-depth-it-IT.html
 prev: displaying-data-it-IT.html
 next: jsx-spread-it-IT.html
 ---
diff --git a/docs/02.1-jsx-in-depth.ja-JP.md b/docs/02.1-jsx-in-depth.ja-JP.md
index 06ca5fbbb..4400ca013 100644
--- a/docs/02.1-jsx-in-depth.ja-JP.md
+++ b/docs/02.1-jsx-in-depth.ja-JP.md
@@ -1,7 +1,7 @@
 ---
 id: jsx-in-depth
 title: JSXの深層
-permalink: jsx-in-depth-ja-JP.html
+permalink: docs/jsx-in-depth-ja-JP.html
 prev: displaying-data-ja-JP.html
 next: jsx-spread-ja_JP.html
 ---
diff --git a/docs/02.1-jsx-in-depth.ko-KR.md b/docs/02.1-jsx-in-depth.ko-KR.md
index fa64acb85..0b3dca553 100644
--- a/docs/02.1-jsx-in-depth.ko-KR.md
+++ b/docs/02.1-jsx-in-depth.ko-KR.md
@@ -1,7 +1,7 @@
 ---
 id: jsx-in-depth-ko-KR
 title: JSX 깊이보기
-permalink: jsx-in-depth-ko-KR.html
+permalink: docs/jsx-in-depth-ko-KR.html
 prev: displaying-data-ko-KR.html
 next: jsx-spread-ko-KR.html
 ---
diff --git a/docs/02.1-jsx-in-depth.md b/docs/02.1-jsx-in-depth.md
index a7bb79b8e..9a3a77cc9 100644
--- a/docs/02.1-jsx-in-depth.md
+++ b/docs/02.1-jsx-in-depth.md
@@ -1,7 +1,7 @@
 ---
 id: jsx-in-depth
 title: JSX in Depth
-permalink: jsx-in-depth.html
+permalink: docs/jsx-in-depth.html
 prev: displaying-data.html
 next: jsx-spread.html
 ---
diff --git a/docs/02.1-jsx-in-depth.zh-CN.md b/docs/02.1-jsx-in-depth.zh-CN.md
index c1857152d..ebf5aa26d 100644
--- a/docs/02.1-jsx-in-depth.zh-CN.md
+++ b/docs/02.1-jsx-in-depth.zh-CN.md
@@ -1,7 +1,7 @@
 ---
 id: jsx-in-depth-zh-CN
 title: 深入 JSX
-permalink: jsx-in-depth-zh-CN.html
+permalink: docs/jsx-in-depth-zh-CN.html
 prev: displaying-data-zh-CN.html
 next: jsx-spread-zh-CN.html
 ---
diff --git a/docs/02.2-jsx-spread.it-IT.md b/docs/02.2-jsx-spread.it-IT.md
index bad3e38d7..6c7799055 100644
--- a/docs/02.2-jsx-spread.it-IT.md
+++ b/docs/02.2-jsx-spread.it-IT.md
@@ -1,7 +1,7 @@
 ---
 id: jsx-spread-it-IT
 title: Attributi Spread JSX
-permalink: jsx-spread-it-IT.html
+permalink: docs/jsx-spread-it-IT.html
 prev: jsx-in-depth-it-IT.html
 next: jsx-gotchas-it-IT.html
 ---
diff --git a/docs/02.2-jsx-spread.ja-JP.md b/docs/02.2-jsx-spread.ja-JP.md
index 42f0c8edc..c3c14f4cf 100644
--- a/docs/02.2-jsx-spread.ja-JP.md
+++ b/docs/02.2-jsx-spread.ja-JP.md
@@ -1,7 +1,7 @@
 ---
 id: jsx-spread
 title: JSXの拡張属性
-permalink: jsx-spread-ja-JP.html
+permalink: docs/jsx-spread-ja-JP.html
 prev: jsx-in-depth-ja-JP.html
 next: jsx-gotchas-ja-JP.html
 ---
diff --git a/docs/02.2-jsx-spread.ko-KR.md b/docs/02.2-jsx-spread.ko-KR.md
index 4c2a5d0cd..ea63c5eee 100644
--- a/docs/02.2-jsx-spread.ko-KR.md
+++ b/docs/02.2-jsx-spread.ko-KR.md
@@ -1,7 +1,7 @@
 ---
 id: jsx-spread-ko-KR
 title: JSX 스프레드 어트리뷰트
-permalink: jsx-spread-ko-KR.html
+permalink: docs/jsx-spread-ko-KR.html
 prev: jsx-in-depth-ko-KR.html
 next: jsx-gotchas-ko-KR.html
 ---
diff --git a/docs/02.2-jsx-spread.md b/docs/02.2-jsx-spread.md
index a4b267824..2363d7268 100644
--- a/docs/02.2-jsx-spread.md
+++ b/docs/02.2-jsx-spread.md
@@ -1,7 +1,7 @@
 ---
 id: jsx-spread
 title: JSX Spread Attributes
-permalink: jsx-spread.html
+permalink: docs/jsx-spread.html
 prev: jsx-in-depth.html
 next: jsx-gotchas.html
 ---
diff --git a/docs/02.2-jsx-spread.zh-CN.md b/docs/02.2-jsx-spread.zh-CN.md
index a7386d201..7d381f8b0 100644
--- a/docs/02.2-jsx-spread.zh-CN.md
+++ b/docs/02.2-jsx-spread.zh-CN.md
@@ -1,7 +1,7 @@
 ---
 id: jsx-spread-zh-CN
 title: JSX 展开属性
-permalink: jsx-spread-zh-CN.html
+permalink: docs/jsx-spread-zh-CN.html
 prev: jsx-in-depth-zh-CN.html
 next: jsx-gotchas-zh-CN.html
 ---
diff --git a/docs/02.3-jsx-gotchas.it-IT.md b/docs/02.3-jsx-gotchas.it-IT.md
index e6c3d5354..7b28ac4cf 100644
--- a/docs/02.3-jsx-gotchas.it-IT.md
+++ b/docs/02.3-jsx-gotchas.it-IT.md
@@ -1,7 +1,7 @@
 ---
 id: jsx-gotchas-it-IT
 title: JSX Gotchas
-permalink: jsx-gotchas-it-IT.html
+permalink: docs/jsx-gotchas-it-IT.html
 prev: jsx-spread-it-IT.html
 next: interactivity-and-dynamic-uis-it-IT.html
 ---
diff --git a/docs/02.3-jsx-gotchas.ja-JP.md b/docs/02.3-jsx-gotchas.ja-JP.md
index f3ee5f420..18b202483 100644
--- a/docs/02.3-jsx-gotchas.ja-JP.md
+++ b/docs/02.3-jsx-gotchas.ja-JP.md
@@ -1,7 +1,7 @@
 ---
 id: jsx-gotchas
 title: JSXの理解
-permalink: jsx-gotchas-ja-JP.html
+permalink: docs/jsx-gotchas-ja-JP.html
 prev: jsx-spread-ja-JP.html
 next: interactivity-and-dynamic-uis-ja-JP.html
 
diff --git a/docs/02.3-jsx-gotchas.ko-KR.md b/docs/02.3-jsx-gotchas.ko-KR.md
index 3dd72770e..a2900cd58 100644
--- a/docs/02.3-jsx-gotchas.ko-KR.md
+++ b/docs/02.3-jsx-gotchas.ko-KR.md
@@ -1,7 +1,7 @@
 ---
 id: jsx-gotchas-ko-KR
 title: JSX Gotchas
-permalink: jsx-gotchas-ko-KR.html
+permalink: docs/jsx-gotchas-ko-KR.html
 prev: jsx-spread-ko-KR.html
 next: interactivity-and-dynamic-uis-ko-KR.html
 ---
diff --git a/docs/02.3-jsx-gotchas.md b/docs/02.3-jsx-gotchas.md
index ce6deee71..8d167bbd9 100644
--- a/docs/02.3-jsx-gotchas.md
+++ b/docs/02.3-jsx-gotchas.md
@@ -1,7 +1,7 @@
 ---
 id: jsx-gotchas
 title: JSX Gotchas
-permalink: jsx-gotchas.html
+permalink: docs/jsx-gotchas.html
 prev: jsx-spread.html
 next: interactivity-and-dynamic-uis.html
 ---
diff --git a/docs/02.3-jsx-gotchas.zh-CN.md b/docs/02.3-jsx-gotchas.zh-CN.md
index 695e68adf..2127ebcdf 100644
--- a/docs/02.3-jsx-gotchas.zh-CN.md
+++ b/docs/02.3-jsx-gotchas.zh-CN.md
@@ -1,7 +1,7 @@
 ---
 id: jsx-gotchas-zh-CN
 title: JSX 陷阱
-permalink: jsx-gotchas-zh-CN.html
+permalink: docs/jsx-gotchas-zh-CN.html
 prev: jsx-spread-zh-CN.html
 next: interactivity-and-dynamic-uis-zh-CN.html
 ---
diff --git a/docs/03-interactivity-and-dynamic-uis.it-IT.md b/docs/03-interactivity-and-dynamic-uis.it-IT.md
index 0bfbbdb39..5aea1b9eb 100644
--- a/docs/03-interactivity-and-dynamic-uis.it-IT.md
+++ b/docs/03-interactivity-and-dynamic-uis.it-IT.md
@@ -1,7 +1,7 @@
 ---
 id: interactivity-and-dynamic-uis-it-IT
 title: Interattività e UI Dinamiche
-permalink: interactivity-and-dynamic-uis-it-IT.html
+permalink: docs/interactivity-and-dynamic-uis-it-IT.html
 prev: jsx-gotchas-it-IT.html
 next: multiple-components-it-IT.html
 ---
diff --git a/docs/03-interactivity-and-dynamic-uis.ja-JP.md b/docs/03-interactivity-and-dynamic-uis.ja-JP.md
index fc2f1cce8..a2e09662c 100644
--- a/docs/03-interactivity-and-dynamic-uis.ja-JP.md
+++ b/docs/03-interactivity-and-dynamic-uis.ja-JP.md
@@ -1,7 +1,7 @@
 ---
 id: interactivity-and-dynamic-uis
 title: 相互作用と動的なUI
-permalink: interactivity-and-dynamic-uis-ja-JP.html
+permalink: docs/interactivity-and-dynamic-uis-ja-JP.html
 prev: jsx-gotchas-ja-JP.html
 next: multiple-components-ja-JP.html
 ---
diff --git a/docs/03-interactivity-and-dynamic-uis.ko-KR.md b/docs/03-interactivity-and-dynamic-uis.ko-KR.md
index 47602d02c..b1f94053e 100644
--- a/docs/03-interactivity-and-dynamic-uis.ko-KR.md
+++ b/docs/03-interactivity-and-dynamic-uis.ko-KR.md
@@ -1,7 +1,7 @@
 ---
 id: interactivity-and-dynamic-uis-ko-KR
 title: 상호 작용 및 동적 UI
-permalink: interactivity-and-dynamic-uis-ko-KR.html
+permalink: docs/interactivity-and-dynamic-uis-ko-KR.html
 prev: jsx-gotchas-ko-KR.html
 next: multiple-components-ko-KR.html
 ---
diff --git a/docs/03-interactivity-and-dynamic-uis.md b/docs/03-interactivity-and-dynamic-uis.md
index 983d9ec62..57b5ff8ef 100644
--- a/docs/03-interactivity-and-dynamic-uis.md
+++ b/docs/03-interactivity-and-dynamic-uis.md
@@ -1,7 +1,7 @@
 ---
 id: interactivity-and-dynamic-uis
 title: Interactivity and Dynamic UIs
-permalink: interactivity-and-dynamic-uis.html
+permalink: docs/interactivity-and-dynamic-uis.html
 prev: jsx-gotchas.html
 next: multiple-components.html
 ---
diff --git a/docs/03-interactivity-and-dynamic-uis.zh-CN.md b/docs/03-interactivity-and-dynamic-uis.zh-CN.md
index 555782ce6..09548c102 100644
--- a/docs/03-interactivity-and-dynamic-uis.zh-CN.md
+++ b/docs/03-interactivity-and-dynamic-uis.zh-CN.md
@@ -1,7 +1,7 @@
 ---
 id: interactivity-and-dynamic-uis-zh-CN
 title: 动态交互式用户界面
-permalink: interactivity-and-dynamic-uis-zh-CN.html
+permalink: docs/interactivity-and-dynamic-uis-zh-CN.html
 prev: jsx-gotchas-zh-CN.html
 next: multiple-components-zh-CN.html
 ---
diff --git a/docs/04-multiple-components.it-IT.md b/docs/04-multiple-components.it-IT.md
index 84b6f80aa..91a1b9f43 100644
--- a/docs/04-multiple-components.it-IT.md
+++ b/docs/04-multiple-components.it-IT.md
@@ -1,7 +1,7 @@
 ---
 id: multiple-components-it-IT
 title: Componenti Multipli
-permalink: multiple-components-it-IT.html
+permalink: docs/multiple-components-it-IT.html
 prev: interactivity-and-dynamic-uis-it-IT.html
 next: reusable-components-it-IT.html
 ---
diff --git a/docs/04-multiple-components.ja-JP.md b/docs/04-multiple-components.ja-JP.md
index 1d6e363ec..39b5dfe84 100644
--- a/docs/04-multiple-components.ja-JP.md
+++ b/docs/04-multiple-components.ja-JP.md
@@ -1,7 +1,7 @@
 ---
 id: multiple-components
 title: 複数のコンポーネント
-permalink: multiple-components-ja-JP.html
+permalink: docs/multiple-components-ja-JP.html
 prev: interactivity-and-dynamic-uis-ja-JP.html
 next: reusable-components-ja-JP.html
 ---
diff --git a/docs/04-multiple-components.ko-KR.md b/docs/04-multiple-components.ko-KR.md
index ec8d8c751..47f763103 100644
--- a/docs/04-multiple-components.ko-KR.md
+++ b/docs/04-multiple-components.ko-KR.md
@@ -1,7 +1,7 @@
 ---
 id: multiple-components-ko-KR
 title: 복합 컴포넌트
-permalink: multiple-components-ko-KR.html
+permalink: docs/multiple-components-ko-KR.html
 prev: interactivity-and-dynamic-uis-ko-KR.html
 next: reusable-components-ko-KR.html
 ---
diff --git a/docs/04-multiple-components.md b/docs/04-multiple-components.md
index 08009746f..24323a9cf 100644
--- a/docs/04-multiple-components.md
+++ b/docs/04-multiple-components.md
@@ -1,7 +1,7 @@
 ---
 id: multiple-components
 title: Multiple Components
-permalink: multiple-components.html
+permalink: docs/multiple-components.html
 prev: interactivity-and-dynamic-uis.html
 next: reusable-components.html
 ---
diff --git a/docs/04-multiple-components.zh-CN.md b/docs/04-multiple-components.zh-CN.md
index 309d44eb9..502fe8b42 100644
--- a/docs/04-multiple-components.zh-CN.md
+++ b/docs/04-multiple-components.zh-CN.md
@@ -1,7 +1,7 @@
 ---
 id: multiple-components-zh-CN
 title: 复合组件
-permalink: multiple-components-zh-CN.html
+permalink: docs/multiple-components-zh-CN.html
 prev: interactivity-and-dynamic-uis-zh-CN.html
 next: reusable-components-zh-CN.html
 ---
diff --git a/docs/05-reusable-components.it-IT.md b/docs/05-reusable-components.it-IT.md
index 162667771..976f43d65 100644
--- a/docs/05-reusable-components.it-IT.md
+++ b/docs/05-reusable-components.it-IT.md
@@ -1,7 +1,7 @@
 ---
 id: reusable-components-it-IT
 title: Componenti Riutilizzabili
-permalink: reusable-components-it-IT.html
+permalink: docs/reusable-components-it-IT.html
 prev: multiple-components-it-IT.html
 next: transferring-props-it-IT.html
 ---
diff --git a/docs/05-reusable-components.ja-JP.md b/docs/05-reusable-components.ja-JP.md
index 57e7e8b77..4c86bbb43 100644
--- a/docs/05-reusable-components.ja-JP.md
+++ b/docs/05-reusable-components.ja-JP.md
@@ -1,7 +1,7 @@
 ---
 id: reusable-components
 title: 再利用可能なコンポーネント
-permalink: reusable-components-ja-JP.html
+permalink: docs/reusable-components-ja-JP.html
 prev: multiple-components-ja-JP.html
 next: transferring-props-ja-JP.html
 ---
diff --git a/docs/05-reusable-components.ko-KR.md b/docs/05-reusable-components.ko-KR.md
index 4ee605ba5..c8aea7650 100644
--- a/docs/05-reusable-components.ko-KR.md
+++ b/docs/05-reusable-components.ko-KR.md
@@ -1,7 +1,7 @@
 ---
 id: reusable-components-ko-KR
 title: 재사용가능한 컴포넌트
-permalink: reusable-components-ko-KR.html
+permalink: docs/reusable-components-ko-KR.html
 prev: multiple-components-ko-KR.html
 next: transferring-props-ko-KR.html
 ---
diff --git a/docs/05-reusable-components.md b/docs/05-reusable-components.md
index 77440a49a..fff3c39a0 100644
--- a/docs/05-reusable-components.md
+++ b/docs/05-reusable-components.md
@@ -1,7 +1,7 @@
 ---
 id: reusable-components
 title: Reusable Components
-permalink: reusable-components.html
+permalink: docs/reusable-components.html
 prev: multiple-components.html
 next: transferring-props.html
 ---
diff --git a/docs/05-reusable-components.zh-CN.md b/docs/05-reusable-components.zh-CN.md
index 1ba8f3a0b..c0ecd2a9c 100644
--- a/docs/05-reusable-components.zh-CN.md
+++ b/docs/05-reusable-components.zh-CN.md
@@ -1,7 +1,7 @@
 ---
 id: reusable-components-zh-CN
 title: 可复用组件
-permalink: reusable-components-zh-CN.html
+permalink: docs/reusable-components-zh-CN.html
 prev: multiple-components-zh-CN.html
 next: transferring-props-zh-CN.html
 ---
diff --git a/docs/06-transferring-props.it-IT.md b/docs/06-transferring-props.it-IT.md
index 7c828480c..0eda8733c 100644
--- a/docs/06-transferring-props.it-IT.md
+++ b/docs/06-transferring-props.it-IT.md
@@ -1,7 +1,7 @@
 ---
 id: transferring-props-it-IT
 title: Trasferimento delle Proprietà
-permalink: transferring-props-it-IT.html
+permalink: docs/transferring-props-it-IT.html
 prev: reusable-components-it-IT.html
 next: forms-it-IT.html
 ---
diff --git a/docs/06-transferring-props.ja-JP.md b/docs/06-transferring-props.ja-JP.md
index 129009472..a1af1cdd6 100644
--- a/docs/06-transferring-props.ja-JP.md
+++ b/docs/06-transferring-props.ja-JP.md
@@ -1,7 +1,7 @@
 ---
 id: transferring-props
 title: propsの移譲
-permalink: transferring-props-ja-JP.html
+permalink: docs/transferring-props-ja-JP.html
 prev: reusable-components-ja-JP.html
 next: forms-ja-JP.html
 
diff --git a/docs/06-transferring-props.ko-KR.md b/docs/06-transferring-props.ko-KR.md
index 1f4b29483..1ee1b811f 100644
--- a/docs/06-transferring-props.ko-KR.md
+++ b/docs/06-transferring-props.ko-KR.md
@@ -1,7 +1,7 @@
 ---
 id: transferring-props-ko-KR
 title: Props 전달
-permalink: transferring-props-ko-KR.html
+permalink: docs/transferring-props-ko-KR.html
 prev: reusable-components-ko-KR.html
 next: forms-ko-KR.html
 ---
diff --git a/docs/06-transferring-props.md b/docs/06-transferring-props.md
index 6b2280e41..63de5f9fd 100644
--- a/docs/06-transferring-props.md
+++ b/docs/06-transferring-props.md
@@ -1,7 +1,7 @@
 ---
 id: transferring-props
 title: Transferring Props
-permalink: transferring-props.html
+permalink: docs/transferring-props.html
 prev: reusable-components.html
 next: forms.html
 ---
diff --git a/docs/06-transferring-props.zh-CN.md b/docs/06-transferring-props.zh-CN.md
index 6bf89aa24..4b92c19ff 100644
--- a/docs/06-transferring-props.zh-CN.md
+++ b/docs/06-transferring-props.zh-CN.md
@@ -1,7 +1,7 @@
 ---
 id: transferring-props-zh-CN
 title: 传递 Props
-permalink: transferring-props-zh-CN.html
+permalink: docs/transferring-props-zh-CN.html
 prev: reusable-components-zh-CN.html
 next: forms-zh-CN.html
 ---
diff --git a/docs/07-forms.it-IT.md b/docs/07-forms.it-IT.md
index eb601a39e..a93db4fa4 100644
--- a/docs/07-forms.it-IT.md
+++ b/docs/07-forms.it-IT.md
@@ -1,7 +1,7 @@
 ---
 id: forms-it-IT
 title: Moduli
-permalink: forms-it-IT.html
+permalink: docs/forms-it-IT.html
 prev: transferring-props-it-IT.html
 next: working-with-the-browser-it-IT.html
 ---
diff --git a/docs/07-forms.ja-JP.md b/docs/07-forms.ja-JP.md
index 04d8530d4..b7854bb98 100644
--- a/docs/07-forms.ja-JP.md
+++ b/docs/07-forms.ja-JP.md
@@ -1,7 +1,7 @@
 ---
 id: forms
 title: フォーム
-permalink: forms-ja-JP.html
+permalink: docs/forms-ja-JP.html
 prev: transferring-props-ja-JP.html
 next: working-with-the-browser-ja-JP.html
 ---
diff --git a/docs/07-forms.ko-KR.md b/docs/07-forms.ko-KR.md
index a40583a6c..7dd7874f2 100644
--- a/docs/07-forms.ko-KR.md
+++ b/docs/07-forms.ko-KR.md
@@ -1,7 +1,7 @@
 ---
 id: forms-ko-KR
 title: 폼
-permalink: forms-ko-KR.html
+permalink: docs/forms-ko-KR.html
 prev: transferring-props-ko-KR.html
 next: working-with-the-browser-ko-KR.html
 ---
diff --git a/docs/07-forms.md b/docs/07-forms.md
index db65f1844..6ab90effd 100644
--- a/docs/07-forms.md
+++ b/docs/07-forms.md
@@ -1,7 +1,7 @@
 ---
 id: forms
 title: Forms
-permalink: forms.html
+permalink: docs/forms.html
 prev: transferring-props.html
 next: working-with-the-browser.html
 ---
diff --git a/docs/07-forms.zh-CN.md b/docs/07-forms.zh-CN.md
index bda03b7be..e7cd5a1cb 100644
--- a/docs/07-forms.zh-CN.md
+++ b/docs/07-forms.zh-CN.md
@@ -1,7 +1,7 @@
 ---
 id: forms-zh-CN
 title: 表单组件
-permalink: forms-zh-CN.html
+permalink: docs/forms-zh-CN.html
 prev: transferring-props-zh-CN.html
 next: working-with-the-browser-zh-CN.html
 ---
diff --git a/docs/08-working-with-the-browser.it-IT.md b/docs/08-working-with-the-browser.it-IT.md
index bc78bf8e1..49a3cc916 100644
--- a/docs/08-working-with-the-browser.it-IT.md
+++ b/docs/08-working-with-the-browser.it-IT.md
@@ -1,7 +1,7 @@
 ---
 id: working-with-the-browser-it-IT
 title: Lavorare con il Browser
-permalink: working-with-the-browser-it-IT.html
+permalink: docs/working-with-the-browser-it-IT.html
 prev: forms-it-IT.html
 next: more-about-refs-it-IT.html
 ---
diff --git a/docs/08-working-with-the-browser.ja-JP.md b/docs/08-working-with-the-browser.ja-JP.md
index f8e0dee80..adc65f57a 100644
--- a/docs/08-working-with-the-browser.ja-JP.md
+++ b/docs/08-working-with-the-browser.ja-JP.md
@@ -1,7 +1,7 @@
 ---
 id: working-with-the-browser
 title: ブラウザと動くこと
-permalink: working-with-the-browser-ja-JP.html
+permalink: docs/working-with-the-browser-ja-JP.html
 prev: forms-ja-JP.html
 next: more-about-refs-ja-JP.html
 ---
diff --git a/docs/08-working-with-the-browser.ko-KR.md b/docs/08-working-with-the-browser.ko-KR.md
index 6b9e51ea6..ae8bec40e 100644
--- a/docs/08-working-with-the-browser.ko-KR.md
+++ b/docs/08-working-with-the-browser.ko-KR.md
@@ -1,7 +1,7 @@
 ---
 id: working-with-the-browser-ko-KR
 title: 브라우저에서의 동작
-permalink: working-with-the-browser-ko-KR.html
+permalink: docs/working-with-the-browser-ko-KR.html
 prev: forms-ko-KR.html
 next: more-about-refs-ko-KR.html
 ---
diff --git a/docs/08-working-with-the-browser.md b/docs/08-working-with-the-browser.md
index 645f66850..b2cbc4f7a 100644
--- a/docs/08-working-with-the-browser.md
+++ b/docs/08-working-with-the-browser.md
@@ -1,7 +1,7 @@
 ---
 id: working-with-the-browser
 title: Working With the Browser
-permalink: working-with-the-browser.html
+permalink: docs/working-with-the-browser.html
 prev: forms.html
 next: more-about-refs.html
 ---
diff --git a/docs/08-working-with-the-browser.zh-CN.md b/docs/08-working-with-the-browser.zh-CN.md
index 0a21d85c1..8c82a2cf2 100644
--- a/docs/08-working-with-the-browser.zh-CN.md
+++ b/docs/08-working-with-the-browser.zh-CN.md
@@ -1,7 +1,7 @@
 ---
 id: working-with-the-browser-zh-CN
 title: 与浏览器协作
-permalink: working-with-the-browser-zh-CN.html
+permalink: docs/working-with-the-browser-zh-CN.html
 prev: forms-zh-CN.html
 next: more-about-refs-zh-CN.html
 ---
diff --git a/docs/08.1-more-about-refs.it-IT.md b/docs/08.1-more-about-refs.it-IT.md
index 2fbff0b73..f2b45398a 100644
--- a/docs/08.1-more-about-refs.it-IT.md
+++ b/docs/08.1-more-about-refs.it-IT.md
@@ -1,7 +1,7 @@
 ---
 id: more-about-refs-it-IT
 title: Riferimenti ai Componenti
-permalink: more-about-refs-it-IT.html
+permalink: docs/more-about-refs-it-IT.html
 prev: working-with-the-browser-it-IT.html
 next: tooling-integration-it-IT.html
 ---
diff --git a/docs/08.1-more-about-refs.ja-JP.md b/docs/08.1-more-about-refs.ja-JP.md
index 1b27d6c09..d444265bb 100644
--- a/docs/08.1-more-about-refs.ja-JP.md
+++ b/docs/08.1-more-about-refs.ja-JP.md
@@ -1,7 +1,7 @@
 ---
 id: more-about-refs
 title: 参照についての詳細
-permalink: more-about-refs-ja-JP.html
+permalink: docs/more-about-refs-ja-JP.html
 prev: working-with-the-browser-ja-JP.html
 next: tooling-integration-ja-JP.html
 
diff --git a/docs/08.1-more-about-refs.ko-KR.md b/docs/08.1-more-about-refs.ko-KR.md
index 9611c4488..4876acf31 100644
--- a/docs/08.1-more-about-refs.ko-KR.md
+++ b/docs/08.1-more-about-refs.ko-KR.md
@@ -1,7 +1,7 @@
 ---
 id: more-about-refs-ko-KR
 title: refs에서 컴포넌트로
-permalink: more-about-refs-ko-KR.html
+permalink: docs/more-about-refs-ko-KR.html
 prev: working-with-the-browser-ko-KR.html
 next: tooling-integration-ko-KR.html
 ---
diff --git a/docs/08.1-more-about-refs.md b/docs/08.1-more-about-refs.md
index b67d569fd..acbef1541 100644
--- a/docs/08.1-more-about-refs.md
+++ b/docs/08.1-more-about-refs.md
@@ -1,7 +1,7 @@
 ---
 id: more-about-refs
 title: Refs to Components
-permalink: more-about-refs.html
+permalink: docs/more-about-refs.html
 prev: working-with-the-browser.html
 next: tooling-integration.html
 ---
diff --git a/docs/08.1-more-about-refs.zh-CN.md b/docs/08.1-more-about-refs.zh-CN.md
index 7223edfda..40df4aaa1 100644
--- a/docs/08.1-more-about-refs.zh-CN.md
+++ b/docs/08.1-more-about-refs.zh-CN.md
@@ -1,7 +1,7 @@
 ---
 id: more-about-refs-zh-CN
 title: 对组件的refs
-permalink: more-about-refs-zh-CN.html
+permalink: docs/more-about-refs-zh-CN.html
 prev: working-with-the-browser-zh-CN.html
 next: tooling-integration-zh-CN.html
 ---
diff --git a/docs/09-tooling-integration.it-IT.md b/docs/09-tooling-integration.it-IT.md
index a9e03108a..b96c44c92 100644
--- a/docs/09-tooling-integration.it-IT.md
+++ b/docs/09-tooling-integration.it-IT.md
@@ -1,7 +1,7 @@
 ---
 id: tooling-integration-it-IT
 title: Integrazione con Strumenti
-permalink: tooling-integration-it-IT.html
+permalink: docs/tooling-integration-it-IT.html
 prev: more-about-refs-it-IT.html
 next: addons-it-IT.html
 ---
diff --git a/docs/09-tooling-integration.ja-JP.md b/docs/09-tooling-integration.ja-JP.md
index dac8fe1e9..49e4ec299 100644
--- a/docs/09-tooling-integration.ja-JP.md
+++ b/docs/09-tooling-integration.ja-JP.md
@@ -1,7 +1,7 @@
 ---
 id: tooling-integration
 title: インテグレーションツール
-permalink: tooling-integration-ja-JP.html
+permalink: docs/tooling-integration-ja-JP.html
 prev: more-about-refs-ja-JP.html
 next: addons-ja-JP.html
 ---
diff --git a/docs/09-tooling-integration.ko-KR.md b/docs/09-tooling-integration.ko-KR.md
index db7722074..0dd5f582b 100644
--- a/docs/09-tooling-integration.ko-KR.md
+++ b/docs/09-tooling-integration.ko-KR.md
@@ -1,7 +1,7 @@
 ---
 id: tooling-integration-ko-KR
 title: 툴 통합
-permalink: tooling-integration-ko-KR.html
+permalink: docs/tooling-integration-ko-KR.html
 prev: more-about-refs-ko-KR.html
 next: addons-ko-KR.html
 ---
diff --git a/docs/09-tooling-integration.md b/docs/09-tooling-integration.md
index b6de0a380..400ad0e26 100644
--- a/docs/09-tooling-integration.md
+++ b/docs/09-tooling-integration.md
@@ -1,7 +1,7 @@
 ---
 id: tooling-integration
 title: Tooling Integration
-permalink: tooling-integration.html
+permalink: docs/tooling-integration.html
 prev: more-about-refs.html
 next: language-tooling.html
 ---
diff --git a/docs/09-tooling-integration.zh-CN.md b/docs/09-tooling-integration.zh-CN.md
index 3471219e5..f2c332056 100644
--- a/docs/09-tooling-integration.zh-CN.md
+++ b/docs/09-tooling-integration.zh-CN.md
@@ -1,7 +1,7 @@
 ---
 id: tooling-integration-zh-CN
 title: 工具集成
-permalink: tooling-integration-zh-CN.html
+permalink: docs/tooling-integration-zh-CN.html
 prev: more-about-refs-zh-CN.html
 next: addons-zh-CN.html
 ---
diff --git a/docs/09.1-language-tooling.md b/docs/09.1-language-tooling.md
index 31fcc5fc4..79f24480f 100644
--- a/docs/09.1-language-tooling.md
+++ b/docs/09.1-language-tooling.md
@@ -1,7 +1,7 @@
 ---
 id: language-tooling
 title: Language Tooling
-permalink: language-tooling.html
+permalink: docs/language-tooling.html
 prev: tooling-integration.html
 next: package-management.html
 ---
diff --git a/docs/09.2-package-management.md b/docs/09.2-package-management.md
index 4ef112771..3b4e03fb0 100644
--- a/docs/09.2-package-management.md
+++ b/docs/09.2-package-management.md
@@ -1,7 +1,7 @@
 ---
 id: package-management
 title: Package Management
-permalink: package-management.html
+permalink: docs/package-management.html
 prev: language-tooling.html
 next: environments.html
 ---
diff --git a/docs/09.3-environments.md b/docs/09.3-environments.md
index eb3c2e1b9..eb3f91d87 100644
--- a/docs/09.3-environments.md
+++ b/docs/09.3-environments.md
@@ -1,7 +1,7 @@
 ---
 id: environments
 title: Server-side Environments
-permalink: environments.html
+permalink: docs/environments.html
 prev: package-management.html
 next: addons.html
 ---
diff --git a/docs/10-addons.it-IT.md b/docs/10-addons.it-IT.md
index 51c06f3b1..abbb3d488 100644
--- a/docs/10-addons.it-IT.md
+++ b/docs/10-addons.it-IT.md
@@ -1,7 +1,7 @@
 ---
 id: addons-it-IT
 title: Add-ons
-permalink: addons-it-IT.html
+permalink: docs/addons-it-IT.html
 prev: tooling-integration-it-IT.html
 next: animation-it-IT.html
 ---
diff --git a/docs/10-addons.ja-JP.md b/docs/10-addons.ja-JP.md
index df9b68b64..9733aa25b 100644
--- a/docs/10-addons.ja-JP.md
+++ b/docs/10-addons.ja-JP.md
@@ -1,7 +1,7 @@
 ---
 id: addons
 title: アドオン
-permalink: addons-ja-JP.html
+permalink: docs/addons-ja-JP.html
 prev: tooling-integration-ja-JP.html
 next: animation-ja-JP.html
 ---
diff --git a/docs/10-addons.ko-KR.md b/docs/10-addons.ko-KR.md
index 86339f2ff..2a7059994 100644
--- a/docs/10-addons.ko-KR.md
+++ b/docs/10-addons.ko-KR.md
@@ -1,7 +1,7 @@
 ---
 id: addons-ko-KR
 title: 애드온
-permalink: addons-ko-KR.html
+permalink: docs/addons-ko-KR.html
 prev: tooling-integration-ko-KR.html
 next: animation-ko-KR.html
 ---
diff --git a/docs/10-addons.md b/docs/10-addons.md
index 9911a0057..9fa7b56db 100644
--- a/docs/10-addons.md
+++ b/docs/10-addons.md
@@ -1,7 +1,7 @@
 ---
 id: addons
 title: Add-ons
-permalink: addons.html
+permalink: docs/addons.html
 prev: environments.html
 next: animation.html
 ---
diff --git a/docs/10-addons.zh-CN.md b/docs/10-addons.zh-CN.md
index 468373b7b..e9392b7ba 100644
--- a/docs/10-addons.zh-CN.md
+++ b/docs/10-addons.zh-CN.md
@@ -1,7 +1,7 @@
 ---
 id: addons-zh-CN
 title: 插件
-permalink: addons-zh-CN.html
+permalink: docs/addons-zh-CN.html
 prev: tooling-integration-zh-CN.html
 next: animation-zh-CN.html
 ---
diff --git a/docs/10.1-animation.it-IT.md b/docs/10.1-animation.it-IT.md
index 609b1c28a..f3c35ec99 100644
--- a/docs/10.1-animation.it-IT.md
+++ b/docs/10.1-animation.it-IT.md
@@ -1,7 +1,7 @@
 ---
 id: animation-it-IT
 title: Animazioni
-permalink: animation-it-IT.html
+permalink: docs/animation-it-IT.html
 prev: addons-it-IT.html
 next: two-way-binding-helpers-it-IT.html
 ---
diff --git a/docs/10.1-animation.ja-JP.md b/docs/10.1-animation.ja-JP.md
index be3c1378a..8cde1d34d 100644
--- a/docs/10.1-animation.ja-JP.md
+++ b/docs/10.1-animation.ja-JP.md
@@ -1,7 +1,7 @@
 ---
 id: animation
 title: アニメーション
-permalink: animation-ja-JP.html
+permalink: docs/animation-ja-JP.html
 prev: addons-ja-JP.html
 next: two-way-binding-helpers-ja-JP.html
 ---
diff --git a/docs/10.1-animation.ko-KR.md b/docs/10.1-animation.ko-KR.md
index dc6d5f14d..76ef892a0 100644
--- a/docs/10.1-animation.ko-KR.md
+++ b/docs/10.1-animation.ko-KR.md
@@ -1,7 +1,7 @@
 ---
 id: animation-ko-KR
 title: 애니메이션
-permalink: animation-ko-KR.html
+permalink: docs/animation-ko-KR.html
 prev: addons-ko-KR.html
 next: two-way-binding-helpers-ko-KR.html
 ---
diff --git a/docs/10.1-animation.md b/docs/10.1-animation.md
index 117b0e77e..c41dbd360 100644
--- a/docs/10.1-animation.md
+++ b/docs/10.1-animation.md
@@ -1,7 +1,7 @@
 ---
 id: animation
 title: Animation
-permalink: animation.html
+permalink: docs/animation.html
 prev: addons.html
 next: two-way-binding-helpers.html
 ---
diff --git a/docs/10.1-animation.zh-CN.md b/docs/10.1-animation.zh-CN.md
index e24c578cf..00c0065d6 100644
--- a/docs/10.1-animation.zh-CN.md
+++ b/docs/10.1-animation.zh-CN.md
@@ -1,7 +1,7 @@
 ---
 id: animation-zh-CN
 title: 动画
-permalink: animation-zh-CN.html
+permalink: docs/animation-zh-CN.html
 prev: addons-zh-CN.html
 next: two-way-binding-helpers-zh-CN.html
 ---
diff --git a/docs/10.10-shallow-compare.md b/docs/10.10-shallow-compare.md
index 08f30c5b1..39042092e 100644
--- a/docs/10.10-shallow-compare.md
+++ b/docs/10.10-shallow-compare.md
@@ -1,7 +1,7 @@
 ---
 id: shallow-compare
 title: Shallow Compare
-permalink: shallow-compare.html
+permalink: docs/shallow-compare.html
 prev: perf.html
 next: advanced-performance.html
 ---
diff --git a/docs/10.10-shallow-compare.zh-CN.md b/docs/10.10-shallow-compare.zh-CN.md
index 6ed9a161b..9bb61cb98 100644
--- a/docs/10.10-shallow-compare.zh-CN.md
+++ b/docs/10.10-shallow-compare.zh-CN.md
@@ -1,7 +1,7 @@
 ---
 id: shallow-compare-zh-CN
 title: 浅比较
-permalink: shallow-compare-zh-CN.html
+permalink: docs/shallow-compare-zh-CN.html
 prev: perf-zh-CN.html
 next: advanced-performance-zh-CN.html
 ---
diff --git a/docs/10.2-form-input-binding-sugar.it-IT.md b/docs/10.2-form-input-binding-sugar.it-IT.md
index 923bd07f1..a3d1662b3 100644
--- a/docs/10.2-form-input-binding-sugar.it-IT.md
+++ b/docs/10.2-form-input-binding-sugar.it-IT.md
@@ -1,7 +1,7 @@
 ---
 id: two-way-binding-helpers-it-IT
 title: Helper Per Binding Bidirezionali
-permalink: two-way-binding-helpers-it-IT.html
+permalink: docs/two-way-binding-helpers-it-IT.html
 prev: animation-it-IT.html
 next: test-utils-it-IT.html
 ---
diff --git a/docs/10.2-form-input-binding-sugar.ja-JP.md b/docs/10.2-form-input-binding-sugar.ja-JP.md
index 7f5ee3c96..9e456847d 100644
--- a/docs/10.2-form-input-binding-sugar.ja-JP.md
+++ b/docs/10.2-form-input-binding-sugar.ja-JP.md
@@ -1,7 +1,7 @@
 ---
 id: two-way-binding-helpers
 title: 2ウェイバインディングのヘルパ
-permalink: two-way-binding-helpers-ja-JP.html
+permalink: docs/two-way-binding-helpers-ja-JP.html
 prev: animation-ja-JP.html
 next: test-utils-ja-JP.html
 ---
diff --git a/docs/10.2-form-input-binding-sugar.ko-KR.md b/docs/10.2-form-input-binding-sugar.ko-KR.md
index e7c46602e..a24572108 100644
--- a/docs/10.2-form-input-binding-sugar.ko-KR.md
+++ b/docs/10.2-form-input-binding-sugar.ko-KR.md
@@ -1,7 +1,7 @@
 ---
 id: two-way-binding-helpers-ko-KR
 title: 양방향 바인딩 핼퍼
-permalink: two-way-binding-helpers-ko-KR.html
+permalink: docs/two-way-binding-helpers-ko-KR.html
 prev: animation-ko-KR.html
 next: test-utils-ko-KR.html
 ---
diff --git a/docs/10.2-form-input-binding-sugar.md b/docs/10.2-form-input-binding-sugar.md
index 7c4ae378e..5ac0f27ce 100644
--- a/docs/10.2-form-input-binding-sugar.md
+++ b/docs/10.2-form-input-binding-sugar.md
@@ -1,7 +1,7 @@
 ---
 id: two-way-binding-helpers
 title: Two-Way Binding Helpers
-permalink: two-way-binding-helpers.html
+permalink: docs/two-way-binding-helpers.html
 prev: animation.html
 next: test-utils.html
 ---
diff --git a/docs/10.2-form-input-binding-sugar.zh-CN.md b/docs/10.2-form-input-binding-sugar.zh-CN.md
index 5adb0145d..5bb3f3121 100644
--- a/docs/10.2-form-input-binding-sugar.zh-CN.md
+++ b/docs/10.2-form-input-binding-sugar.zh-CN.md
@@ -1,7 +1,7 @@
 ---
 id: two-way-binding-helpers-zh-CN
 title: 双向绑定辅助
-permalink: two-way-binding-helpers-zh-CN.html
+permalink: docs/two-way-binding-helpers-zh-CN.html
 prev: animation-zh-CN.html
 next: test-utils-zh-CN.html
 ---
diff --git a/docs/10.3-class-name-manipulation.it-IT.md b/docs/10.3-class-name-manipulation.it-IT.md
index 9ec5c2cd0..7fb9da766 100644
--- a/docs/10.3-class-name-manipulation.it-IT.md
+++ b/docs/10.3-class-name-manipulation.it-IT.md
@@ -1,7 +1,7 @@
 ---
 id: class-name-manipulation-it-IT
 title: Manipolazione del Nome di Classe
-permalink: class-name-manipulation-it-IT.html
+permalink: docs/class-name-manipulation-it-IT.html
 prev: two-way-binding-helpers-it-IT.html
 next: test-utils-it-IT.html
 ---
diff --git a/docs/10.3-class-name-manipulation.ja-JP.md b/docs/10.3-class-name-manipulation.ja-JP.md
index d96ecb44f..ecbde7448 100644
--- a/docs/10.3-class-name-manipulation.ja-JP.md
+++ b/docs/10.3-class-name-manipulation.ja-JP.md
@@ -1,7 +1,7 @@
 ---
 id: class-name-manipulation
 title: クラス名の操作
-permalink: class-name-manipulation-ja-JP.html
+permalink: docs/class-name-manipulation-ja-JP.html
 prev: two-way-binding-helpers-ja-JP.html
 next: test-utils-ja-JP.html
 ---
diff --git a/docs/10.3-class-name-manipulation.ko-KR.md b/docs/10.3-class-name-manipulation.ko-KR.md
index 463d6a1db..6e11d8d6e 100644
--- a/docs/10.3-class-name-manipulation.ko-KR.md
+++ b/docs/10.3-class-name-manipulation.ko-KR.md
@@ -1,7 +1,7 @@
 ---
 id: class-name-manipulation-ko-KR
 title: 클래스 이름 조작
-permalink: class-name-manipulation-ko-KR.html
+permalink: docs/class-name-manipulation-ko-KR.html
 prev: two-way-binding-helpers-ko-KR.html
 next: test-utils-ko-KR.html
 ---
diff --git a/docs/10.3-class-name-manipulation.md b/docs/10.3-class-name-manipulation.md
index 4a3567d41..ad529525c 100644
--- a/docs/10.3-class-name-manipulation.md
+++ b/docs/10.3-class-name-manipulation.md
@@ -1,7 +1,7 @@
 ---
 id: class-name-manipulation
 title: Class Name Manipulation
-permalink: class-name-manipulation.html
+permalink: docs/class-name-manipulation.html
 prev: two-way-binding-helpers.html
 next: test-utils.html
 ---
diff --git a/docs/10.3-class-name-manipulation.zh-CN.md b/docs/10.3-class-name-manipulation.zh-CN.md
index 48b38d909..d3ab80f43 100644
--- a/docs/10.3-class-name-manipulation.zh-CN.md
+++ b/docs/10.3-class-name-manipulation.zh-CN.md
@@ -1,7 +1,7 @@
 ---
 id: class-name-manipulation-zh-CN
 title: 类名操纵
-permalink: class-name-manipulation-zh-CN.html
+permalink: docs/class-name-manipulation-zh-CN.html
 prev: two-way-binding-helpers-zh-CN.html
 next: test-utils-zh-CN.html
 ---
diff --git a/docs/10.4-test-utils.it-IT.md b/docs/10.4-test-utils.it-IT.md
index 2cf3262fd..0b8602465 100644
--- a/docs/10.4-test-utils.it-IT.md
+++ b/docs/10.4-test-utils.it-IT.md
@@ -1,7 +1,7 @@
 ---
 id: test-utils-it-IT
 title: Utilità di Test
-permalink: test-utils-it-IT.html
+permalink: docs/test-utils-it-IT.html
 prev: two-way-binding-helpers-it-IT.html
 next: clone-with-props-it-IT.html
 ---
diff --git a/docs/10.4-test-utils.ja-JP.md b/docs/10.4-test-utils.ja-JP.md
index 81d0d16be..37e8daaff 100644
--- a/docs/10.4-test-utils.ja-JP.md
+++ b/docs/10.4-test-utils.ja-JP.md
@@ -1,7 +1,7 @@
 ---
 id: test-utils
 title: テストユーティリティ
-permalink: test-utils-ja-JP.html
+permalink: docs/test-utils-ja-JP.html
 prev: two-way-binding-helpers-ja-JP.html
 next: clone-with-props-ja-JP.html
 ---
diff --git a/docs/10.4-test-utils.ko-KR.md b/docs/10.4-test-utils.ko-KR.md
index ee44011bf..e9ac34e76 100644
--- a/docs/10.4-test-utils.ko-KR.md
+++ b/docs/10.4-test-utils.ko-KR.md
@@ -1,7 +1,7 @@
 ---
 id: test-utils-ko-KR
 title: 테스트 유틸리티
-permalink: test-utils-ko-KR.html
+permalink: docs/test-utils-ko-KR.html
 prev: two-way-binding-helpers-ko-KR.html
 next: clone-with-props-ko-KR.html
 ---
diff --git a/docs/10.4-test-utils.md b/docs/10.4-test-utils.md
index 1a1a84aff..dccecaae2 100644
--- a/docs/10.4-test-utils.md
+++ b/docs/10.4-test-utils.md
@@ -1,7 +1,7 @@
 ---
 id: test-utils
 title: Test Utilities
-permalink: test-utils.html
+permalink: docs/test-utils.html
 prev: two-way-binding-helpers.html
 next: clone-with-props.html
 ---
diff --git a/docs/10.4-test-utils.zh-CN.md b/docs/10.4-test-utils.zh-CN.md
index 8a01890d9..3666672fa 100644
--- a/docs/10.4-test-utils.zh-CN.md
+++ b/docs/10.4-test-utils.zh-CN.md
@@ -1,7 +1,7 @@
 ---
 id: test-utils-zh-CN
 title: 测试工具
-permalink: test-utils-zh-CN.html
+permalink: docs/test-utils-zh-CN.html
 prev: two-way-binding-helpers-zh-CN.html
 next: clone-with-props-zh-CN.html
 ---
diff --git a/docs/10.5-clone-with-props.it-IT.md b/docs/10.5-clone-with-props.it-IT.md
index 019af4ede..ee690b9a5 100644
--- a/docs/10.5-clone-with-props.it-IT.md
+++ b/docs/10.5-clone-with-props.it-IT.md
@@ -1,7 +1,7 @@
 ---
 id: clone-with-props-it-IT
 title: Clonare ReactElements
-permalink: clone-with-props-it-IT.html
+permalink: docs/clone-with-props-it-IT.html
 prev: test-utils-it-IT.html
 next: create-fragment-it-IT.html
 ---
diff --git a/docs/10.5-clone-with-props.ja-JP.md b/docs/10.5-clone-with-props.ja-JP.md
index 21b1c73b6..3f7159325 100644
--- a/docs/10.5-clone-with-props.ja-JP.md
+++ b/docs/10.5-clone-with-props.ja-JP.md
@@ -1,7 +1,7 @@
 ---
 id: clone-with-props
 title: ReactElementsをクローンすること
-permalink: clone-with-props-ja-JP.html
+permalink: docs/clone-with-props-ja-JP.html
 prev: test-utils-ja-JP.html
 next: create-fragment-ja-JP.html
 ---
diff --git a/docs/10.5-clone-with-props.ko-KR.md b/docs/10.5-clone-with-props.ko-KR.md
index ebc0bd872..c909ad73d 100644
--- a/docs/10.5-clone-with-props.ko-KR.md
+++ b/docs/10.5-clone-with-props.ko-KR.md
@@ -1,7 +1,7 @@
 ---
 id: clone-with-props-ko-KR
 title: ReactElement 클론하기
-permalink: clone-with-props-ko-KR.html
+permalink: docs/clone-with-props-ko-KR.html
 prev: test-utils-ko-KR.html
 next: create-fragment-ko-KR.html
 ---
diff --git a/docs/10.5-clone-with-props.md b/docs/10.5-clone-with-props.md
index 279d04a98..dc1c14a32 100644
--- a/docs/10.5-clone-with-props.md
+++ b/docs/10.5-clone-with-props.md
@@ -1,7 +1,7 @@
 ---
 id: clone-with-props
 title: Cloning ReactElements
-permalink: clone-with-props.html
+permalink: docs/clone-with-props.html
 prev: test-utils.html
 next: create-fragment.html
 ---
diff --git a/docs/10.5-clone-with-props.zh-CN.md b/docs/10.5-clone-with-props.zh-CN.md
index ea970ad1b..5d2bf2002 100644
--- a/docs/10.5-clone-with-props.zh-CN.md
+++ b/docs/10.5-clone-with-props.zh-CN.md
@@ -1,7 +1,7 @@
 ---
 id: clone-with-props-zh-CN
 title: 克隆 ReactElements
-permalink: clone-with-props-zh-CN.html
+permalink: docs/clone-with-props-zh-CN.html
 prev: test-utils-zh-CN.html
 next: create-fragment-zh-CN.html
 ---
diff --git a/docs/10.6-create-fragment.it-IT.md b/docs/10.6-create-fragment.it-IT.md
index 11971643f..2325eb4e9 100644
--- a/docs/10.6-create-fragment.it-IT.md
+++ b/docs/10.6-create-fragment.it-IT.md
@@ -1,7 +1,7 @@
 ---
 id: create-fragment-it-IT
 title: Frammenti con Chiave
-permalink: create-fragment-it-IT.html
+permalink: docs/create-fragment-it-IT.html
 prev: clone-with-props-it-IT.html
 next: update-it-IT.html
 ---
diff --git a/docs/10.6-create-fragment.ja-JP.md b/docs/10.6-create-fragment.ja-JP.md
index 11b6dd306..3de2fce77 100644
--- a/docs/10.6-create-fragment.ja-JP.md
+++ b/docs/10.6-create-fragment.ja-JP.md
@@ -1,7 +1,7 @@
 ---
 id: create-fragment
 title: キー付けされたフラグメント
-permalink: create-fragment-ja-JP.html
+permalink: docs/create-fragment-ja-JP.html
 prev: clone-with-props-ja-JP.html
 next: update-ja-JP.html
 ---
diff --git a/docs/10.6-create-fragment.ko-KR.md b/docs/10.6-create-fragment.ko-KR.md
index c2bae58ec..6e4d2a177 100644
--- a/docs/10.6-create-fragment.ko-KR.md
+++ b/docs/10.6-create-fragment.ko-KR.md
@@ -1,7 +1,7 @@
 ---
 id: create-fragment-ko-KR
 title: 키가 할당된 프래그먼트
-permalink: create-fragment-ko-KR.html
+permalink: docs/create-fragment-ko-KR.html
 prev: clone-with-props-ko-KR.html
 next: update-ko-KR.html
 ---
diff --git a/docs/10.6-create-fragment.md b/docs/10.6-create-fragment.md
index 91879d4e0..94d9267e5 100644
--- a/docs/10.6-create-fragment.md
+++ b/docs/10.6-create-fragment.md
@@ -1,7 +1,7 @@
 ---
 id: create-fragment
 title: Keyed Fragments
-permalink: create-fragment.html
+permalink: docs/create-fragment.html
 prev: clone-with-props.html
 next: update.html
 ---
diff --git a/docs/10.6-create-fragment.zh-CN.md b/docs/10.6-create-fragment.zh-CN.md
index 661cef570..620bba48c 100644
--- a/docs/10.6-create-fragment.zh-CN.md
+++ b/docs/10.6-create-fragment.zh-CN.md
@@ -1,7 +1,7 @@
 ---
 id: create-fragment-zh-CN
 title: Keyed Fragments
-permalink: create-fragment-zh-CN.html
+permalink: docs/create-fragment-zh-CN.html
 prev: clone-with-props-zh-CN.html
 next: update-zh-CN.html
 ---
diff --git a/docs/10.7-update.it-IT.md b/docs/10.7-update.it-IT.md
index 3477f63ce..8cd3165b0 100644
--- a/docs/10.7-update.it-IT.md
+++ b/docs/10.7-update.it-IT.md
@@ -1,7 +1,7 @@
 ---
 id: update-it-IT
 title: Helper per l'Immutabilità
-permalink: update-it-IT.html
+permalink: docs/update-it-IT.html
 prev: create-fragment-it-IT.html
 next: pure-render-mixin-it-IT.html
 ---
diff --git a/docs/10.7-update.ja-JP.md b/docs/10.7-update.ja-JP.md
index b472c7e5f..fb54233ae 100644
--- a/docs/10.7-update.ja-JP.md
+++ b/docs/10.7-update.ja-JP.md
@@ -1,7 +1,7 @@
 ---
 id: update
 title: 不変性のヘルパ
-permalink: update-ja-JP.html
+permalink: docs/update-ja-JP.html
 prev: create-fragment-ja-JP.html
 next: pure-render-mixin-ja-JP.html
 ---
diff --git a/docs/10.7-update.ko-KR.md b/docs/10.7-update.ko-KR.md
index cc96b1c31..fd32304b2 100644
--- a/docs/10.7-update.ko-KR.md
+++ b/docs/10.7-update.ko-KR.md
@@ -1,7 +1,7 @@
 ---
 id: update-ko-KR
 title: 불변성 헬퍼들
-permalink: update-ko-KR.html
+permalink: docs/update-ko-KR.html
 prev: create-fragment-ko-KR.html
 next: pure-render-mixin-ko-KR.html
 ---
diff --git a/docs/10.7-update.md b/docs/10.7-update.md
index a9dcdf7f6..e76f47ac1 100644
--- a/docs/10.7-update.md
+++ b/docs/10.7-update.md
@@ -1,7 +1,7 @@
 ---
 id: update
 title: Immutability Helpers
-permalink: update.html
+permalink: docs/update.html
 prev: create-fragment.html
 next: pure-render-mixin.html
 ---
diff --git a/docs/10.7-update.zh-CN.md b/docs/10.7-update.zh-CN.md
index ea1b3b734..36fc29472 100644
--- a/docs/10.7-update.zh-CN.md
+++ b/docs/10.7-update.zh-CN.md
@@ -1,7 +1,7 @@
 ---
 id: update-zh-CN
 title: immutability 助手
-permalink: update-zh-CN.html
+permalink: docs/update-zh-CN.html
 prev: create-fragment-zh-CN.html
 next: pure-render-mixin-zh-CN.html
 ---
diff --git a/docs/10.8-pure-render-mixin.it-IT.md b/docs/10.8-pure-render-mixin.it-IT.md
index bce1a42fa..1dccb3b46 100644
--- a/docs/10.8-pure-render-mixin.it-IT.md
+++ b/docs/10.8-pure-render-mixin.it-IT.md
@@ -1,7 +1,7 @@
 ---
 id: pure-render-mixin-it-IT
 title: PureRenderMixin
-permalink: pure-render-mixin-it-IT.html
+permalink: docs/pure-render-mixin-it-IT.html
 prev: update-it-IT.html
 next: perf-it-IT.html
 ---
diff --git a/docs/10.8-pure-render-mixin.ja-JP.md b/docs/10.8-pure-render-mixin.ja-JP.md
index 967315164..2ac3314f8 100644
--- a/docs/10.8-pure-render-mixin.ja-JP.md
+++ b/docs/10.8-pure-render-mixin.ja-JP.md
@@ -1,7 +1,7 @@
 ---
 id: pure-render-mixin
 title: PureRenderMixin
-permalink: pure-render-mixin-ja-JP.html
+permalink: docs/pure-render-mixin-ja-JP.html
 prev: update-ja-JP.html
 next: perf-ja-JP.html
 ---
diff --git a/docs/10.8-pure-render-mixin.ko-KR.md b/docs/10.8-pure-render-mixin.ko-KR.md
index 34fadd75d..8a4338c0f 100644
--- a/docs/10.8-pure-render-mixin.ko-KR.md
+++ b/docs/10.8-pure-render-mixin.ko-KR.md
@@ -1,7 +1,7 @@
 ---
 id: pure-render-mixin-ko-KR
 title: PureRenderMixin
-permalink: pure-render-mixin-ko-KR.html
+permalink: docs/pure-render-mixin-ko-KR.html
 prev: update-ko-KR.html
 next: perf-ko-KR.html
 ---
diff --git a/docs/10.8-pure-render-mixin.md b/docs/10.8-pure-render-mixin.md
index 5b8c4099f..708a03680 100644
--- a/docs/10.8-pure-render-mixin.md
+++ b/docs/10.8-pure-render-mixin.md
@@ -1,7 +1,7 @@
 ---
 id: pure-render-mixin
 title: PureRenderMixin
-permalink: pure-render-mixin.html
+permalink: docs/pure-render-mixin.html
 prev: update.html
 next: perf.html
 ---
diff --git a/docs/10.8-pure-render-mixin.zh-CN.md b/docs/10.8-pure-render-mixin.zh-CN.md
index d37e92758..a767a0b1b 100644
--- a/docs/10.8-pure-render-mixin.zh-CN.md
+++ b/docs/10.8-pure-render-mixin.zh-CN.md
@@ -1,7 +1,7 @@
 ---
 id: pure-render-mixin-zh-CN
 title: PureRenderMixin
-permalink: pure-render-mixin-zh-CN.html
+permalink: docs/pure-render-mixin-zh-CN.html
 prev: update-zh-CN.html
 next: perf-zh-CN.html
 ---
diff --git a/docs/10.9-perf.it-IT.md b/docs/10.9-perf.it-IT.md
index 3ef53e5e0..8d9ed17e7 100644
--- a/docs/10.9-perf.it-IT.md
+++ b/docs/10.9-perf.it-IT.md
@@ -1,7 +1,7 @@
 ---
 id: perf-it-IT
 title: Strumenti per la Performance
-permalink: perf-it-IT.html
+permalink: docs/perf-it-IT.html
 prev: pure-render-mixin-it-IT.html
 next: advanced-performance-it-IT.html
 ---
diff --git a/docs/10.9-perf.ja-JP.md b/docs/10.9-perf.ja-JP.md
index 7c7024a71..df5d09c2f 100644
--- a/docs/10.9-perf.ja-JP.md
+++ b/docs/10.9-perf.ja-JP.md
@@ -1,7 +1,7 @@
 ---
 id: perf
 title: パフォーマンスツール
-permalink: perf-ja-JP.html
+permalink: docs/perf-ja-JP.html
 prev: pure-render-mixin-ja-JP.html
 next: advanced-performance-ja-JP.html
 ---
diff --git a/docs/10.9-perf.ko-KR.md b/docs/10.9-perf.ko-KR.md
index 62e679b0f..f5766967c 100644
--- a/docs/10.9-perf.ko-KR.md
+++ b/docs/10.9-perf.ko-KR.md
@@ -1,7 +1,7 @@
 ---
 id: perf-ko-KR
 title: 성능 도구
-permalink: perf-ko-KR.html
+permalink: docs/perf-ko-KR.html
 prev: pure-render-mixin-ko-KR.html
 next: advanced-performance-ko-KR.html
 ---
diff --git a/docs/10.9-perf.md b/docs/10.9-perf.md
index ae736b247..69ace66e6 100644
--- a/docs/10.9-perf.md
+++ b/docs/10.9-perf.md
@@ -1,7 +1,7 @@
 ---
 id: perf
 title: Performance Tools
-permalink: perf.html
+permalink: docs/perf.html
 prev: pure-render-mixin.html
 next: shallow-compare.html
 ---
diff --git a/docs/10.9-perf.zh-CN.md b/docs/10.9-perf.zh-CN.md
index b4f314bc3..621404670 100644
--- a/docs/10.9-perf.zh-CN.md
+++ b/docs/10.9-perf.zh-CN.md
@@ -1,7 +1,7 @@
 ---
 id: perf-zh-CN
 title: 性能工具
-permalink: perf-zh-CN.html
+permalink: docs/perf-zh-CN.html
 prev: pure-render-mixin-zh-CN.html
 next: shallow-compare-zh-CN.html
 ---
diff --git a/docs/11-advanced-performance.it-IT.md b/docs/11-advanced-performance.it-IT.md
index 625b48a3c..0841a3b83 100644
--- a/docs/11-advanced-performance.it-IT.md
+++ b/docs/11-advanced-performance.it-IT.md
@@ -1,7 +1,7 @@
 ---
 id: advanced-performance-it-IT
 title: Performance Avanzata
-permalink: advanced-performance-it-IT.html
+permalink: docs/advanced-performance-it-IT.html
 prev: perf-it-IT.html
 ---
 
diff --git a/docs/11-advanced-performance.ja-JP.md b/docs/11-advanced-performance.ja-JP.md
index a17b28f82..0df476c81 100644
--- a/docs/11-advanced-performance.ja-JP.md
+++ b/docs/11-advanced-performance.ja-JP.md
@@ -1,7 +1,7 @@
 ---
 id: advanced-performance
 title: 先進的なパフォーマンス
-permalink: advanced-performance-ja-JP.html
+permalink: docs/advanced-performance-ja-JP.html
 prev: perf-ja-JP.html
 ---
 
diff --git a/docs/11-advanced-performance.ko-KR.md b/docs/11-advanced-performance.ko-KR.md
index 413c1eb23..52ee1f35b 100644
--- a/docs/11-advanced-performance.ko-KR.md
+++ b/docs/11-advanced-performance.ko-KR.md
@@ -1,7 +1,7 @@
 ---
 id: advanced-performance-ko-KR
 title: 성능 심화
-permalink: advanced-performance-ko-KR.html
+permalink: docs/advanced-performance-ko-KR.html
 prev: perf-ko-KR.html
 next: context-ko-KR.html
 ---
diff --git a/docs/11-advanced-performance.md b/docs/11-advanced-performance.md
index 399ccacb3..09e0b10f4 100644
--- a/docs/11-advanced-performance.md
+++ b/docs/11-advanced-performance.md
@@ -1,7 +1,7 @@
 ---
 id: advanced-performance
 title: Advanced Performance
-permalink: advanced-performance.html
+permalink: docs/advanced-performance.html
 prev: shallow-compare.html
 next: context.html
 ---
diff --git a/docs/12-context.ko-KR.md b/docs/12-context.ko-KR.md
index a15d5397d..764b84627 100644
--- a/docs/12-context.ko-KR.md
+++ b/docs/12-context.ko-KR.md
@@ -1,7 +1,7 @@
 ---
 id: context
 title: 컨텍스트
-permalink: context-ko-KR.html
+permalink: docs/context-ko-KR.html
 prev: advanced-performance-ko-KR.html
 ---
 
diff --git a/docs/12-context.md b/docs/12-context.md
index cab78f523..1cbc37818 100644
--- a/docs/12-context.md
+++ b/docs/12-context.md
@@ -1,7 +1,7 @@
 ---
 id: context
 title: Context
-permalink: context.html
+permalink: docs/context.html
 prev: advanced-performance.html
 ---
 
diff --git a/docs/12-context.zh-CN.md b/docs/12-context.zh-CN.md
index 885e94728..5b114d45f 100644
--- a/docs/12-context.zh-CN.md
+++ b/docs/12-context.zh-CN.md
@@ -1,7 +1,7 @@
 ---
 id: context-zh-CN
 title: Context
-permalink: context-zh-CN.html
+permalink: docs/context-zh-CN.html
 prev: advanced-performance-zh-CN.html
 ---
 
diff --git a/docs/complementary-tools.it-IT.md b/docs/complementary-tools.it-IT.md
index ce1fc965b..def23d848 100644
--- a/docs/complementary-tools.it-IT.md
+++ b/docs/complementary-tools.it-IT.md
@@ -1,5 +1,5 @@
 ---
-permalink: complementary-tools-it-IT.html
+permalink: docs/complementary-tools-it-IT.html
 layout: redirect
 dest_url: https://github.com/facebook/react/wiki/Complementary-Tools
 ---
diff --git a/docs/complementary-tools.ko-KR.md b/docs/complementary-tools.ko-KR.md
index 9807bf079..b41ef3fe7 100644
--- a/docs/complementary-tools.ko-KR.md
+++ b/docs/complementary-tools.ko-KR.md
@@ -1,5 +1,5 @@
 ---
-permalink: complementary-tools-ko-KR.html
+permalink: docs/complementary-tools-ko-KR.html
 layout: redirect
 dest_url: https://github.com/facebook/react/wiki/Complementary-Tools
 ---
diff --git a/docs/complementary-tools.md b/docs/complementary-tools.md
index 10e8dba55..d3dcf0406 100644
--- a/docs/complementary-tools.md
+++ b/docs/complementary-tools.md
@@ -1,5 +1,5 @@
 ---
-permalink: complementary-tools.html
+permalink: docs/complementary-tools.html
 layout: redirect
 dest_url: https://github.com/facebook/react/wiki/Complementary-Tools
 ---
diff --git a/docs/complementary-tools.zh-CN.md b/docs/complementary-tools.zh-CN.md
index 797700c15..e27a8bc5f 100644
--- a/docs/complementary-tools.zh-CN.md
+++ b/docs/complementary-tools.zh-CN.md
@@ -1,5 +1,5 @@
 ---
-permalink: complementary-tools-zh-CN.html
+permalink: docs/complementary-tools-zh-CN.html
 layout: redirect
 dest_url: https://github.com/facebook/react/wiki/Complementary-Tools
 ---
diff --git a/docs/conferences.it-IT.md b/docs/conferences.it-IT.md
index 9a38a6c79..8cd3facb1 100644
--- a/docs/conferences.it-IT.md
+++ b/docs/conferences.it-IT.md
@@ -1,7 +1,7 @@
 ---
 id: conferences-it-IT
 title: Conferenze
-permalink: conferences-it-IT.html
+permalink: docs/conferences-it-IT.html
 prev: thinking-in-react-it-IT.html
 next: videos-it-IT.html
 ---
diff --git a/docs/conferences.ko-KR.md b/docs/conferences.ko-KR.md
index 56502080a..210ab3b52 100644
--- a/docs/conferences.ko-KR.md
+++ b/docs/conferences.ko-KR.md
@@ -1,7 +1,7 @@
 ---
 id: conferences-ko-KR
 title: 컨퍼런스들
-permalink: conferences-ko-KR.html
+permalink: docs/conferences-ko-KR.html
 prev: thinking-in-react-ko-KR.html
 next: videos-ko-KR.html
 ---
diff --git a/docs/conferences.md b/docs/conferences.md
index be7cedb5e..947a98e07 100644
--- a/docs/conferences.md
+++ b/docs/conferences.md
@@ -1,7 +1,7 @@
 ---
 id: conferences
 title: Conferences
-permalink: conferences.html
+permalink: docs/conferences.html
 prev: thinking-in-react.html
 next: videos.html
 ---
diff --git a/docs/conferences.zh-CN.md b/docs/conferences.zh-CN.md
index cc1666d92..5d58aaed6 100644
--- a/docs/conferences.zh-CN.md
+++ b/docs/conferences.zh-CN.md
@@ -1,7 +1,7 @@
 ---
 id: conferences-zh-CN
 title: 会议
-permalink: conferences-zh-CN.html
+permalink: docs/conferences-zh-CN.html
 prev: thinking-in-react-zh-CN.html
 next: videos-zh-CN.html
 ---
diff --git a/docs/examples.it-IT.md b/docs/examples.it-IT.md
index 7166c57bb..592429600 100644
--- a/docs/examples.it-IT.md
+++ b/docs/examples.it-IT.md
@@ -1,5 +1,5 @@
 ---
-permalink: examples-it-IT.html
+permalink: docs/examples-it-IT.html
 layout: redirect
 dest_url: https://github.com/facebook/react/wiki/Examples
 ---
diff --git a/docs/examples.ko-KR.md b/docs/examples.ko-KR.md
index 3b46fa57d..709328358 100644
--- a/docs/examples.ko-KR.md
+++ b/docs/examples.ko-KR.md
@@ -1,5 +1,5 @@
 ---
-permalink: examples-ko-KR.html
+permalink: docs/examples-ko-KR.html
 layout: redirect
 dest_url: https://github.com/facebook/react/wiki/Examples
 ---
diff --git a/docs/examples.md b/docs/examples.md
index c697ffdf5..bccc3287a 100644
--- a/docs/examples.md
+++ b/docs/examples.md
@@ -1,5 +1,5 @@
 ---
-permalink: examples.html
+permalink: docs/examples.html
 layout: redirect
 dest_url: https://github.com/facebook/react/wiki/Examples
 ---
diff --git a/docs/examples.zh-CN.md b/docs/examples.zh-CN.md
index 057bedb9e..ac16cf1bb 100644
--- a/docs/examples.zh-CN.md
+++ b/docs/examples.zh-CN.md
@@ -1,5 +1,5 @@
 ---
-permalink: examples-zh-CN.html
+permalink: docs/examples-zh-CN.html
 layout: redirect
 dest_url: https://github.com/facebook/react/wiki/Examples
 ---
diff --git a/docs/flux-overview.it-IT.md b/docs/flux-overview.it-IT.md
index 7e437de5d..2bb67265a 100644
--- a/docs/flux-overview.it-IT.md
+++ b/docs/flux-overview.it-IT.md
@@ -1,7 +1,7 @@
 ---
 id: flux-overview-it-IT
 title: Architettura di un'Applicazione Flux
-permalink: flux-overview-it-IT.html
+permalink: docs/flux-overview-it-IT.html
 ---
 
 Questa pagina è stata spostata sul sito di Flux. [Leggila qui](https://facebook.github.io/flux/docs/overview.html).
diff --git a/docs/flux-overview.ko-KR.md b/docs/flux-overview.ko-KR.md
index 6129d9655..f85006920 100644
--- a/docs/flux-overview.ko-KR.md
+++ b/docs/flux-overview.ko-KR.md
@@ -1,7 +1,7 @@
 ---
 id: flux-overview-ko-KR
 title: Flux 애플리케이션 아키텍쳐
-permalink: flux-overview-ko-KR.html
+permalink: docs/flux-overview-ko-KR.html
 ---
 
 이 페이지는 Flux 웹사이트로 이동되었습니다. [거기서 보세요](https://facebook.github.io/flux/docs/overview.html).
diff --git a/docs/flux-overview.md b/docs/flux-overview.md
index aa62b4772..69909f67d 100644
--- a/docs/flux-overview.md
+++ b/docs/flux-overview.md
@@ -1,7 +1,7 @@
 ---
 id: flux-overview
 title: Flux Application Architecture
-permalink: flux-overview.html
+permalink: docs/flux-overview.html
 ---
 
 This page has been moved to the Flux website. [View it there](https://facebook.github.io/flux/docs/overview.html).
diff --git a/docs/flux-overview.zh-CN.md b/docs/flux-overview.zh-CN.md
index fe3287c96..77242bf75 100644
--- a/docs/flux-overview.zh-CN.md
+++ b/docs/flux-overview.zh-CN.md
@@ -1,7 +1,7 @@
 ---
 id: flux-overview-zh-CN
 title: Flux 应用架构
-permalink: flux-overview-zh-CN.html
+permalink: docs/flux-overview-zh-CN.html
 ---
 
 本页被移到了 Flux 网站。[点击访问](https://facebook.github.io/flux/docs/overview.html)。
diff --git a/docs/flux-todo-list.it-IT.md b/docs/flux-todo-list.it-IT.md
index 376f6c91d..4adc5f675 100644
--- a/docs/flux-todo-list.it-IT.md
+++ b/docs/flux-todo-list.it-IT.md
@@ -1,7 +1,7 @@
 ---
 id: flux-todo-list-it-IT
 title: Tutorial TodoMVC Flux
-permalink: flux-todo-list-it-IT.html
+permalink: docs/flux-todo-list-it-IT.html
 ---
 
 Questa pagina è stata spostata sul sito di Flux. [Leggila qui](https://facebook.github.io/flux/docs/todo-list.html).
diff --git a/docs/flux-todo-list.ko-KR.md b/docs/flux-todo-list.ko-KR.md
index 327be3889..646b30082 100644
--- a/docs/flux-todo-list.ko-KR.md
+++ b/docs/flux-todo-list.ko-KR.md
@@ -1,7 +1,7 @@
 ---
 id: flux-todo-list-ko-KR
 title: Flux TodoMVC 튜토리얼
-permalink: flux-todo-list-ko-KR.html
+permalink: docs/flux-todo-list-ko-KR.html
 ---
 
 이 페이지는 Flux 웹사이트로 이동되었습니다. [거기서 보세요](https://facebook.github.io/flux/docs/todo-list.html).
diff --git a/docs/flux-todo-list.md b/docs/flux-todo-list.md
index 8c7827f26..b265216e8 100644
--- a/docs/flux-todo-list.md
+++ b/docs/flux-todo-list.md
@@ -1,7 +1,7 @@
 ---
 id: flux-todo-list
 title: Flux TodoMVC Tutorial
-permalink: flux-todo-list.html
+permalink: docs/flux-todo-list.html
 ---
 
 This page has been moved to the Flux website. [View it there](https://facebook.github.io/flux/docs/todo-list.html).
diff --git a/docs/flux-todo-list.zh-CN.md b/docs/flux-todo-list.zh-CN.md
index 076e4af9f..7ce559501 100644
--- a/docs/flux-todo-list.zh-CN.md
+++ b/docs/flux-todo-list.zh-CN.md
@@ -1,7 +1,7 @@
 ---
 id: flux-todo-list-zh-CN
 title: Flux TodoMVC 教程
-permalink: flux-todo-list-zh-CN.html
+permalink: docs/flux-todo-list-zh-CN.html
 ---
 
 本页被移到了 Flux 网站。[点击访问](https://facebook.github.io/flux/docs/todo-list.html)。
diff --git a/docs/getting-started.it-IT.md b/docs/getting-started.it-IT.md
index 8257aeb56..f15d01d6a 100644
--- a/docs/getting-started.it-IT.md
+++ b/docs/getting-started.it-IT.md
@@ -1,7 +1,7 @@
 ---
 id: getting-started-it-IT
 title: Primi Passi
-permalink: getting-started-it-IT.html
+permalink: docs/getting-started-it-IT.html
 next: tutorial-it-IT.html
 redirect_from: "docs/index.html"
 ---
diff --git a/docs/getting-started.ja-JP.md b/docs/getting-started.ja-JP.md
index 11e5d731c..61aa5f0ca 100644
--- a/docs/getting-started.ja-JP.md
+++ b/docs/getting-started.ja-JP.md
@@ -1,7 +1,7 @@
 ---
 id: getting-started-ja-JP
 title: 始めてみましょう
-permalink: getting-started-ja-JP.html
+permalink: docs/getting-started-ja-JP.html
 next: tutorial-ja-JP.html
 redirect_from: "docs/index-ja-JP.html"
 ---
diff --git a/docs/getting-started.ko-KR.md b/docs/getting-started.ko-KR.md
index c3e9656f6..2ee25543e 100644
--- a/docs/getting-started.ko-KR.md
+++ b/docs/getting-started.ko-KR.md
@@ -1,7 +1,7 @@
 ---
 id: getting-started-ko-KR
 title: 시작해보기
-permalink: getting-started-ko-KR.html
+permalink: docs/getting-started-ko-KR.html
 next: tutorial-ko-KR.html
 redirect_from: "docs/index-ko-KR.html"
 ---
diff --git a/docs/getting-started.zh-CN.md b/docs/getting-started.zh-CN.md
index 6457bb34d..242724b69 100644
--- a/docs/getting-started.zh-CN.md
+++ b/docs/getting-started.zh-CN.md
@@ -1,7 +1,7 @@
 ---
 id: getting-started-zh-CN
 title: 入门教程
-permalink: getting-started-zh-CN.html
+permalink: docs/getting-started-zh-CN.html
 next: tutorial-zh-CN.html
 redirect_from: "docs/index-zh-CN.html"
 ---
diff --git a/docs/ref-01-top-level-api.it-IT.md b/docs/ref-01-top-level-api.it-IT.md
index 11953510d..3dbfb43ee 100644
--- a/docs/ref-01-top-level-api.it-IT.md
+++ b/docs/ref-01-top-level-api.it-IT.md
@@ -1,7 +1,7 @@
 ---
 id: top-level-api-it-IT
 title: API di Livello Elevato
-permalink: top-level-api-it-IT.html
+permalink: docs/top-level-api-it-IT.html
 next: component-api-it-IT.html
 redirect_from: "/docs/reference.html"
 ---
diff --git a/docs/ref-01-top-level-api.ja-JP.md b/docs/ref-01-top-level-api.ja-JP.md
index 2896650c8..80459c75c 100644
--- a/docs/ref-01-top-level-api.ja-JP.md
+++ b/docs/ref-01-top-level-api.ja-JP.md
@@ -1,7 +1,7 @@
 ---
 id: top-level-api-ja-JP
 title: Top-Level API
-permalink: top-level-api-ja-JP.html
+permalink: docs/top-level-api-ja-JP.html
 next: component-api-ja-JP.html
 redirect_from: "/docs/reference-ja-JP.html"
 ---
diff --git a/docs/ref-01-top-level-api.ko-KR.md b/docs/ref-01-top-level-api.ko-KR.md
index bb6197029..9c10bace3 100644
--- a/docs/ref-01-top-level-api.ko-KR.md
+++ b/docs/ref-01-top-level-api.ko-KR.md
@@ -1,7 +1,7 @@
 ---
 id: top-level-api-ko-KR
 title: 최상위 API
-permalink: top-level-api-ko-KR.html
+permalink: docs/top-level-api-ko-KR.html
 next: component-api-ko-KR.html
 redirect_from: "/docs/reference-ko-KR.html"
 ---
diff --git a/docs/ref-01-top-level-api.md b/docs/ref-01-top-level-api.md
index 31aa0f92d..c4e9b15d3 100644
--- a/docs/ref-01-top-level-api.md
+++ b/docs/ref-01-top-level-api.md
@@ -1,7 +1,7 @@
 ---
 id: top-level-api
 title: Top-Level API
-permalink: top-level-api.html
+permalink: docs/top-level-api.html
 next: component-api.html
 redirect_from: "/docs/reference.html"
 ---
diff --git a/docs/ref-01-top-level-api.zh-CN.md b/docs/ref-01-top-level-api.zh-CN.md
index cc1e8ef64..96ed01b01 100644
--- a/docs/ref-01-top-level-api.zh-CN.md
+++ b/docs/ref-01-top-level-api.zh-CN.md
@@ -1,7 +1,7 @@
 ---
 id: top-level-api-zh-CN
 title: Top-Level API
-permalink: top-level-api-zh-CN.html
+permalink: docs/top-level-api-zh-CN.html
 next: component-api-zh-CN.html
 redirect_from: "/docs/reference-zh-CN.html"
 ---
diff --git a/docs/ref-02-component-api.it-IT.md b/docs/ref-02-component-api.it-IT.md
index c190d6c55..a70a9ee60 100644
--- a/docs/ref-02-component-api.it-IT.md
+++ b/docs/ref-02-component-api.it-IT.md
@@ -1,7 +1,7 @@
 ---
 id: component-api-it-IT
 title: API dei Componenti
-permalink: component-api-it-IT.html
+permalink: docs/component-api-it-IT.html
 prev: top-level-api-it-IT.html
 next: component-specs-it-IT.html
 ---
diff --git a/docs/ref-02-component-api.ko-KR.md b/docs/ref-02-component-api.ko-KR.md
index ff5144a66..d84d950d1 100644
--- a/docs/ref-02-component-api.ko-KR.md
+++ b/docs/ref-02-component-api.ko-KR.md
@@ -1,7 +1,7 @@
 ---
 id: component-api-ko-KR
 title: 컴포넌트 API
-permalink: component-api-ko-KR.html
+permalink: docs/component-api-ko-KR.html
 prev: top-level-api-ko-KR.html
 next: component-specs-ko-KR.html
 ---
diff --git a/docs/ref-02-component-api.md b/docs/ref-02-component-api.md
index e4603e78c..73710f631 100644
--- a/docs/ref-02-component-api.md
+++ b/docs/ref-02-component-api.md
@@ -1,7 +1,7 @@
 ---
 id: component-api
 title: Component API
-permalink: component-api.html
+permalink: docs/component-api.html
 prev: top-level-api.html
 next: component-specs.html
 ---
diff --git a/docs/ref-02-component-api.zh-CN.md b/docs/ref-02-component-api.zh-CN.md
index 84f18d00a..3ddaa924d 100644
--- a/docs/ref-02-component-api.zh-CN.md
+++ b/docs/ref-02-component-api.zh-CN.md
@@ -1,7 +1,7 @@
 ---
 id: component-api-zh-CN
 title: 组件 API
-permalink: component-api-zh-CN.html
+permalink: docs/component-api-zh-CN.html
 prev: top-level-api-zh-CN.html
 next: component-specs-zh-CN.html
 ---
diff --git a/docs/ref-03-component-specs.it-IT.md b/docs/ref-03-component-specs.it-IT.md
index 42a0e9d72..efde1cbb5 100644
--- a/docs/ref-03-component-specs.it-IT.md
+++ b/docs/ref-03-component-specs.it-IT.md
@@ -1,7 +1,7 @@
 ---
 id: component-specs-it-IT
 title: Specifica dei Componenti e Ciclo di Vita
-permalink: component-specs-it-IT.html
+permalink: docs/component-specs-it-IT.html
 prev: component-api-it-IT.html
 next: tags-and-attributes-it-IT.html
 ---
diff --git a/docs/ref-03-component-specs.ko-KR.md b/docs/ref-03-component-specs.ko-KR.md
index 266ffc218..8163f467c 100644
--- a/docs/ref-03-component-specs.ko-KR.md
+++ b/docs/ref-03-component-specs.ko-KR.md
@@ -1,7 +1,7 @@
 ---
 id: component-specs-ko-KR
 title:  컴포넌트 명세와 생명주기
-permalink: component-specs-ko-KR.html
+permalink: docs/component-specs-ko-KR.html
 prev: component-api-ko-KR.html
 next: tags-and-attributes-ko-KR.html
 ---
diff --git a/docs/ref-03-component-specs.md b/docs/ref-03-component-specs.md
index 9e5a95620..6c0986bf3 100644
--- a/docs/ref-03-component-specs.md
+++ b/docs/ref-03-component-specs.md
@@ -1,7 +1,7 @@
 ---
 id: component-specs
 title: Component Specs and Lifecycle
-permalink: component-specs.html
+permalink: docs/component-specs.html
 prev: component-api.html
 next: tags-and-attributes.html
 ---
diff --git a/docs/ref-03-component-specs.zh-CN.md b/docs/ref-03-component-specs.zh-CN.md
index 95d6cb19a..f1e1a174f 100644
--- a/docs/ref-03-component-specs.zh-CN.md
+++ b/docs/ref-03-component-specs.zh-CN.md
@@ -1,7 +1,7 @@
 ---
 id: component-specs-zh-CN
 title: 组件的规范和生命周期
-permalink: component-specs-zh-CN.html
+permalink: docs/component-specs-zh-CN.html
 prev: component-api-zh-CN.html
 next: tags-and-attributes-zh-CN.html
 ---
diff --git a/docs/ref-04-tags-and-attributes.it-IT.md b/docs/ref-04-tags-and-attributes.it-IT.md
index a8dc279f8..a862010fd 100644
--- a/docs/ref-04-tags-and-attributes.it-IT.md
+++ b/docs/ref-04-tags-and-attributes.it-IT.md
@@ -1,7 +1,7 @@
 ---
 id: tags-and-attributes-it-IT
 title: Tag e Attributi
-permalink: tags-and-attributes-it-IT.html
+permalink: docs/tags-and-attributes-it-IT.html
 prev: component-specs-it-IT.html
 next: events-it-IT.html
 ---
diff --git a/docs/ref-04-tags-and-attributes.ko-KR.md b/docs/ref-04-tags-and-attributes.ko-KR.md
index 4128af23a..deed207fb 100644
--- a/docs/ref-04-tags-and-attributes.ko-KR.md
+++ b/docs/ref-04-tags-and-attributes.ko-KR.md
@@ -1,7 +1,7 @@
 ---
 id: tags-and-attributes-ko-KR
 title: 태그와 어트리뷰트
-permalink: tags-and-attributes-ko-KR.html
+permalink: docs/tags-and-attributes-ko-KR.html
 prev: component-specs-ko-KR.html
 next: events-ko-KR.html
 ---
diff --git a/docs/ref-04-tags-and-attributes.md b/docs/ref-04-tags-and-attributes.md
index 8157582ea..aeae7303d 100644
--- a/docs/ref-04-tags-and-attributes.md
+++ b/docs/ref-04-tags-and-attributes.md
@@ -1,7 +1,7 @@
 ---
 id: tags-and-attributes
 title: Tags and Attributes
-permalink: tags-and-attributes.html
+permalink: docs/tags-and-attributes.html
 prev: component-specs.html
 next: events.html
 ---
diff --git a/docs/ref-04-tags-and-attributes.zh-CN.md b/docs/ref-04-tags-and-attributes.zh-CN.md
index cccd97b7f..9e4a10594 100644
--- a/docs/ref-04-tags-and-attributes.zh-CN.md
+++ b/docs/ref-04-tags-and-attributes.zh-CN.md
@@ -1,7 +1,7 @@
 ---
 id: tags-and-attributes-zh-CN
 title: Tags和属性
-permalink: tags-and-attributes-zh-CN.html
+permalink: docs/tags-and-attributes-zh-CN.html
 prev: component-specs-zh-CN.html
 next: events-zh-CN.html
 ---
diff --git a/docs/ref-05-events.it-IT.md b/docs/ref-05-events.it-IT.md
index 563714733..940fa7014 100644
--- a/docs/ref-05-events.it-IT.md
+++ b/docs/ref-05-events.it-IT.md
@@ -1,7 +1,7 @@
 ---
 id: events-it-IT
 title: Sistema di Eventi
-permalink: events-it-IT.html
+permalink: docs/events-it-IT.html
 prev: tags-and-attributes-it-IT.html
 next: dom-differences-it-IT.html
 ---
diff --git a/docs/ref-05-events.ko-KR.md b/docs/ref-05-events.ko-KR.md
index b727bb90c..88abbf8e7 100644
--- a/docs/ref-05-events.ko-KR.md
+++ b/docs/ref-05-events.ko-KR.md
@@ -1,7 +1,7 @@
 ---
 id: events-ko-KR
 title: 이벤트 시스템
-permalink: events-ko-KR.html
+permalink: docs/events-ko-KR.html
 prev: tags-and-attributes-ko-KR.html
 next: dom-differences-ko-KR.html
 ---
diff --git a/docs/ref-05-events.md b/docs/ref-05-events.md
index a8ed6af79..fbad5411b 100644
--- a/docs/ref-05-events.md
+++ b/docs/ref-05-events.md
@@ -1,7 +1,7 @@
 ---
 id: events
 title: Event System
-permalink: events.html
+permalink: docs/events.html
 prev: tags-and-attributes.html
 next: dom-differences.html
 ---
diff --git a/docs/ref-05-events.zh-CN.md b/docs/ref-05-events.zh-CN.md
index 8305081be..5f2029279 100644
--- a/docs/ref-05-events.zh-CN.md
+++ b/docs/ref-05-events.zh-CN.md
@@ -1,7 +1,7 @@
 ---
 id: events-zh-CN
 title: 事件系统
-permalink: events-zh-CN.html
+permalink: docs/events-zh-CN.html
 prev: tags-and-attributes-zh-CN.html
 next: dom-differences-zh-CN.html
 ---
diff --git a/docs/ref-06-dom-differences.it-IT.md b/docs/ref-06-dom-differences.it-IT.md
index 8fae0c6e3..4b2d5f0f8 100644
--- a/docs/ref-06-dom-differences.it-IT.md
+++ b/docs/ref-06-dom-differences.it-IT.md
@@ -1,7 +1,7 @@
 ---
 id: dom-differences-it-IT
 title: Differenze del DOM
-permalink: dom-differences-it-IT.html
+permalink: docs/dom-differences-it-IT.html
 prev: events-it-IT.html
 next: special-non-dom-attributes-it-IT.html
 ---
diff --git a/docs/ref-06-dom-differences.ko-KR.md b/docs/ref-06-dom-differences.ko-KR.md
index 36d75eca0..a87569d3a 100644
--- a/docs/ref-06-dom-differences.ko-KR.md
+++ b/docs/ref-06-dom-differences.ko-KR.md
@@ -1,7 +1,7 @@
 ---
 id: dom-differences-ko-KR
 title: DOM과의 차이점
-permalink: dom-differences-ko-KR.html
+permalink: docs/dom-differences-ko-KR.html
 prev: events-ko-KR.html
 next: special-non-dom-attributes-ko-KR.html
 ---
diff --git a/docs/ref-06-dom-differences.md b/docs/ref-06-dom-differences.md
index 3d5106187..1b904cb11 100644
--- a/docs/ref-06-dom-differences.md
+++ b/docs/ref-06-dom-differences.md
@@ -1,7 +1,7 @@
 ---
 id: dom-differences
 title: DOM Differences
-permalink: dom-differences.html
+permalink: docs/dom-differences.html
 prev: events.html
 next: special-non-dom-attributes.html
 ---
diff --git a/docs/ref-06-dom-differences.zh-CN.md b/docs/ref-06-dom-differences.zh-CN.md
index 2b869db2b..37251a494 100644
--- a/docs/ref-06-dom-differences.zh-CN.md
+++ b/docs/ref-06-dom-differences.zh-CN.md
@@ -1,7 +1,7 @@
 ---
 id: dom-differences-zh-CN
 title: DOM 的不同之处
-permalink: dom-differences-zh-CN.html
+permalink: docs/dom-differences-zh-CN.html
 prev: events-zh-CN.html
 next: special-non-dom-attributes-zh-CN.html
 ---
diff --git a/docs/ref-07-special-non-dom-attributes.it-IT.md b/docs/ref-07-special-non-dom-attributes.it-IT.md
index 457fd27ea..593a90bc6 100644
--- a/docs/ref-07-special-non-dom-attributes.it-IT.md
+++ b/docs/ref-07-special-non-dom-attributes.it-IT.md
@@ -1,7 +1,7 @@
 ---
 id: special-non-dom-attributes-it-IT
 title: Attributi Speciali Non-DOM
-permalink: special-non-dom-attributes-it-IT.html
+permalink: docs/special-non-dom-attributes-it-IT.html
 prev: dom-differences-it-IT.html
 next: reconciliation-it-IT.html
 ---
diff --git a/docs/ref-07-special-non-dom-attributes.ko-KR.md b/docs/ref-07-special-non-dom-attributes.ko-KR.md
index 54a8c4520..9ee2bf781 100644
--- a/docs/ref-07-special-non-dom-attributes.ko-KR.md
+++ b/docs/ref-07-special-non-dom-attributes.ko-KR.md
@@ -1,7 +1,7 @@
 ---
 id: special-non-dom-attributes-ko-KR
 title: DOM이 아닌 특별한 어트리뷰트
-permalink: special-non-dom-attributes-ko-KR.html
+permalink: docs/special-non-dom-attributes-ko-KR.html
 prev: dom-differences-ko-KR.html
 next: reconciliation-ko-KR.html
 ---
diff --git a/docs/ref-07-special-non-dom-attributes.md b/docs/ref-07-special-non-dom-attributes.md
index f3fd90c16..8e9089e52 100644
--- a/docs/ref-07-special-non-dom-attributes.md
+++ b/docs/ref-07-special-non-dom-attributes.md
@@ -1,7 +1,7 @@
 ---
 id: special-non-dom-attributes
 title: Special Non-DOM Attributes
-permalink: special-non-dom-attributes.html
+permalink: docs/special-non-dom-attributes.html
 prev: dom-differences.html
 next: reconciliation.html
 ---
diff --git a/docs/ref-07-special-non-dom-attributes.zh-CN.md b/docs/ref-07-special-non-dom-attributes.zh-CN.md
index 3b29fe382..926bbd3cb 100644
--- a/docs/ref-07-special-non-dom-attributes.zh-CN.md
+++ b/docs/ref-07-special-non-dom-attributes.zh-CN.md
@@ -1,7 +1,7 @@
 ---
 id: special-non-dom-attributes-zh-CN
 title: 特殊的 Non-DOM Attributes
-permalink: special-non-dom-attributes-zh-CN.html
+permalink: docs/special-non-dom-attributes-zh-CN.html
 prev: dom-differences-zh-CN.html
 next: reconciliation-zh-CN.html
 ---
diff --git a/docs/ref-08-reconciliation.it-IT.md b/docs/ref-08-reconciliation.it-IT.md
index b68e63503..c308d75fb 100644
--- a/docs/ref-08-reconciliation.it-IT.md
+++ b/docs/ref-08-reconciliation.it-IT.md
@@ -1,7 +1,7 @@
 ---
 id: reconciliation-it-IT
 title: Riconciliazione
-permalink: reconciliation-it-IT.html
+permalink: docs/reconciliation-it-IT.html
 prev: special-non-dom-attributes-it-IT.html
 next: webcomponents.html
 ---
diff --git a/docs/ref-08-reconciliation.ko-KR.md b/docs/ref-08-reconciliation.ko-KR.md
index e8bce339a..da5e2135e 100644
--- a/docs/ref-08-reconciliation.ko-KR.md
+++ b/docs/ref-08-reconciliation.ko-KR.md
@@ -1,7 +1,7 @@
 ---
 id: reconciliation-ko-KR
 title: 비교조정(Reconciliation)
-permalink: reconciliation-ko-KR.html
+permalink: docs/reconciliation-ko-KR.html
 prev: special-non-dom-attributes-ko-KR.html
 next: webcomponents.html
 ---
diff --git a/docs/ref-08-reconciliation.md b/docs/ref-08-reconciliation.md
index aefd2edf5..d19331b1d 100644
--- a/docs/ref-08-reconciliation.md
+++ b/docs/ref-08-reconciliation.md
@@ -1,7 +1,7 @@
 ---
 id: reconciliation
 title: Reconciliation
-permalink: reconciliation.html
+permalink: docs/reconciliation.html
 prev: special-non-dom-attributes.html
 next: webcomponents.html
 ---
diff --git a/docs/ref-09-webcomponents.md b/docs/ref-09-webcomponents.md
index 9e26f2501..ab9dace7e 100644
--- a/docs/ref-09-webcomponents.md
+++ b/docs/ref-09-webcomponents.md
@@ -1,7 +1,7 @@
 ---
 id: webcomponents
 title: Web Components
-permalink: webcomponents.html
+permalink: docs/webcomponents.html
 prev: reconciliation.html
 next: glossary.html
 ---
diff --git a/docs/ref-09-webcomponents.zh-CN.md b/docs/ref-09-webcomponents.zh-CN.md
index 7def20fca..dbc9828aa 100644
--- a/docs/ref-09-webcomponents.zh-CN.md
+++ b/docs/ref-09-webcomponents.zh-CN.md
@@ -1,7 +1,7 @@
 ---
 id: webcomponents-zh-CN
 title: Web Components
-permalink: webcomponents-zh-CN.html
+permalink: docs/webcomponents-zh-CN.html
 prev: reconciliation-zh-CN.html
 next: glossary-zh-CN.html
 ---
diff --git a/docs/ref-10-glossary.it-IT.md b/docs/ref-10-glossary.it-IT.md
index 01af918ef..c103cfc38 100644
--- a/docs/ref-10-glossary.it-IT.md
+++ b/docs/ref-10-glossary.it-IT.md
@@ -1,7 +1,7 @@
 ---
 id: glossary-it-IT
 title: Terminologia del DOM (Virtuale)
-permalink: glossary-it-IT.html
+permalink: docs/glossary-it-IT.html
 prev: webcomponents.html
 ---
 
diff --git a/docs/ref-10-glossary.ko-KR.md b/docs/ref-10-glossary.ko-KR.md
index 01131040d..eebd81217 100644
--- a/docs/ref-10-glossary.ko-KR.md
+++ b/docs/ref-10-glossary.ko-KR.md
@@ -1,7 +1,7 @@
 ---
 id: glossary-ko-KR
 title: React (가상) DOM 용어
-permalink: glossary-ko-KR.html
+permalink: docs/glossary-ko-KR.html
 prev: webcomponents-ko-KR.html
 ---
 
diff --git a/docs/ref-10-glossary.md b/docs/ref-10-glossary.md
index ab553e07d..0a1d3ccee 100644
--- a/docs/ref-10-glossary.md
+++ b/docs/ref-10-glossary.md
@@ -1,7 +1,7 @@
 ---
 id: glossary
 title: React (Virtual) DOM Terminology
-permalink: glossary.html
+permalink: docs/glossary.html
 prev: webcomponents.html
 ---
 
diff --git a/docs/ref-10-glossary.zh-CN.md b/docs/ref-10-glossary.zh-CN.md
index 40f61c62b..8ac62aee7 100644
--- a/docs/ref-10-glossary.zh-CN.md
+++ b/docs/ref-10-glossary.zh-CN.md
@@ -1,7 +1,7 @@
 ---
 id: glossary-zh-CN
 title: React (虚拟) DOM 术语
-permalink: glossary-zh-CN.html
+permalink: docs/glossary-zh-CN.html
 prev: webcomponents-zh-CN.html
 ---
 
diff --git a/docs/thinking-in-react.ko-KR.md b/docs/thinking-in-react.ko-KR.md
index 6476545a2..8b5ba49d2 100644
--- a/docs/thinking-in-react.ko-KR.md
+++ b/docs/thinking-in-react.ko-KR.md
@@ -1,7 +1,7 @@
 ---
 id: thinking-in-react-ko-KR
 title: 리액트로 생각해보기
-permalink: thinking-in-react-ko-KR.html
+permalink: docs/thinking-in-react-ko-KR.html
 prev: tutorial-ko-KR.html
 next: videos-ko-KR.html
 ---
diff --git a/docs/tutorial.ja-JP.md b/docs/tutorial.ja-JP.md
index 3caaa1edb..0de8fc8fb 100755
--- a/docs/tutorial.ja-JP.md
+++ b/docs/tutorial.ja-JP.md
@@ -1,7 +1,7 @@
 ---
 id: tutorial-ja-JP
 title: チュートリアル
-permalink: tutorial-ja-JP.html
+permalink: docs/tutorial-ja-JP.html
 prev: getting-started-ja-JP.html
 next: thinking-in-react-ja-JP.html
 ---
diff --git a/docs/tutorial.ko-KR.md b/docs/tutorial.ko-KR.md
index 60a862f23..32ffb18e4 100755
--- a/docs/tutorial.ko-KR.md
+++ b/docs/tutorial.ko-KR.md
@@ -1,7 +1,7 @@
 ---
 id: tutorial-ko-KR
 title: 튜토리얼
-permalink: tutorial-ko-KR.html
+permalink: docs/tutorial-ko-KR.html
 prev: getting-started-ko-KR.html
 next: thinking-in-react-ko-KR.html
 ---
diff --git a/docs/videos.it-IT.md b/docs/videos.it-IT.md
index e03707aef..1ed8bde91 100644
--- a/docs/videos.it-IT.md
+++ b/docs/videos.it-IT.md
@@ -1,7 +1,7 @@
 ---
 id: videos-it-IT
 title: Video
-permalink: videos-it-IT.html
+permalink: docs/videos-it-IT.html
 prev: conferences-it-IT.html
 next: complementary-tools-it-IT.html
 ---
diff --git a/docs/videos.ko-KR.md b/docs/videos.ko-KR.md
index b2270f608..ce3ca177f 100644
--- a/docs/videos.ko-KR.md
+++ b/docs/videos.ko-KR.md
@@ -1,7 +1,7 @@
 ---
 id: videos-ko-KR
 title: 비디오들
-permalink: videos-ko-KR.html
+permalink: docs/videos-ko-KR.html
 prev: conferences-ko-KR.html
 next: complementary-tools-ko-KR.html
 ---
diff --git a/docs/videos.md b/docs/videos.md
index 89f69b54f..9e44f235d 100644
--- a/docs/videos.md
+++ b/docs/videos.md
@@ -1,7 +1,7 @@
 ---
 id: videos
 title: Videos
-permalink: videos.html
+permalink: docs/videos.html
 prev: conferences.html
 next: complementary-tools.html
 ---
diff --git a/docs/videos.zh-CN.md b/docs/videos.zh-CN.md
index 60f928813..344bd5002 100644
--- a/docs/videos.zh-CN.md
+++ b/docs/videos.zh-CN.md
@@ -1,7 +1,7 @@
 ---
 id: videos-zh-CN
 title: 视频
-permalink: videos-zh-CN.html
+permalink: docs/videos-zh-CN.html
 prev: conferences-zh-CN.html
 next: complementary-tools-zh-CN.html
 ---
diff --git a/tips/01-introduction.ja-JP.md b/tips/01-introduction.ja-JP.md
index f4354efee..bb4f37622 100644
--- a/tips/01-introduction.ja-JP.md
+++ b/tips/01-introduction.ja-JP.md
@@ -2,7 +2,7 @@
 id: introduction-ja-JP
 title: イントロダクション
 layout: tips
-permalink: introduction-ja-JP.html
+permalink: tips/introduction-ja-JP.html
 next: inline-styles-ja-JP.html
 ---
 
diff --git a/tips/01-introduction.ko-KR.md b/tips/01-introduction.ko-KR.md
index b8c046371..ce46f9b25 100644
--- a/tips/01-introduction.ko-KR.md
+++ b/tips/01-introduction.ko-KR.md
@@ -2,7 +2,7 @@
 id: introduction-ko-KR
 title: 개요
 layout: tips
-permalink: introduction-ko-KR.html
+permalink: tips/introduction-ko-KR.html
 next: inline-styles-ko-KR.html
 ---
 
diff --git a/tips/01-introduction.md b/tips/01-introduction.md
index 3a95c7673..ced8ea7b2 100644
--- a/tips/01-introduction.md
+++ b/tips/01-introduction.md
@@ -2,7 +2,7 @@
 id: introduction
 title: Introduction
 layout: tips
-permalink: introduction.html
+permalink: tips/introduction.html
 next: inline-styles.html
 ---
 
diff --git a/tips/02-inline-styles.ko-KR.md b/tips/02-inline-styles.ko-KR.md
index f5e0c73d1..7cbe115dc 100644
--- a/tips/02-inline-styles.ko-KR.md
+++ b/tips/02-inline-styles.ko-KR.md
@@ -2,7 +2,7 @@
 id: inline-styles-ko-KR
 title: 인라인 스타일
 layout: tips
-permalink: inline-styles-ko-KR.html
+permalink: tips/inline-styles-ko-KR.html
 next: if-else-in-JSX-ko-KR.html
 prev: introduction-ko-KR.html
 ---
diff --git a/tips/02-inline-styles.md b/tips/02-inline-styles.md
index 1c4ec9698..d36600456 100644
--- a/tips/02-inline-styles.md
+++ b/tips/02-inline-styles.md
@@ -2,7 +2,7 @@
 id: inline-styles
 title: Inline Styles
 layout: tips
-permalink: inline-styles.html
+permalink: tips/inline-styles.html
 next: if-else-in-JSX.html
 prev: introduction.html
 ---
diff --git a/tips/03-if-else-in-JSX.ko-KR.md b/tips/03-if-else-in-JSX.ko-KR.md
index ca5da4b89..53ae4893b 100644
--- a/tips/03-if-else-in-JSX.ko-KR.md
+++ b/tips/03-if-else-in-JSX.ko-KR.md
@@ -2,7 +2,7 @@
 id: if-else-in-JSX-ko-KR
 title: JSX에서 If-Else
 layout: tips
-permalink: if-else-in-JSX-ko-KR.html
+permalink: tips/if-else-in-JSX-ko-KR.html
 prev: inline-styles-ko-KR.html
 next: self-closing-tag-ko-KR.html
 ---
diff --git a/tips/03-if-else-in-JSX.md b/tips/03-if-else-in-JSX.md
index a22a6cf81..4ee308375 100644
--- a/tips/03-if-else-in-JSX.md
+++ b/tips/03-if-else-in-JSX.md
@@ -2,7 +2,7 @@
 id: if-else-in-JSX
 title: If-Else in JSX
 layout: tips
-permalink: if-else-in-JSX.html
+permalink: tips/if-else-in-JSX.html
 prev: inline-styles.html
 next: self-closing-tag.html
 ---
diff --git a/tips/04-self-closing-tag.ja-JP.md b/tips/04-self-closing-tag.ja-JP.md
index 2c411d7e1..6989ffd6e 100644
--- a/tips/04-self-closing-tag.ja-JP.md
+++ b/tips/04-self-closing-tag.ja-JP.md
@@ -2,7 +2,7 @@
 id: self-closing-tag-ja-JP
 title: 自己終了タグ
 layout: tips
-permalink: self-closing-tag-ja-JP.html
+permalink: tips/self-closing-tag-ja-JP.html
 prev: if-else-in-JSX-ja-JP.html
 next: maximum-number-of-jsx-root-nodes-ja-JP.html
 ---
diff --git a/tips/04-self-closing-tag.ko-KR.md b/tips/04-self-closing-tag.ko-KR.md
index a45295925..00055e632 100644
--- a/tips/04-self-closing-tag.ko-KR.md
+++ b/tips/04-self-closing-tag.ko-KR.md
@@ -2,7 +2,7 @@
 id: self-closing-tag-ko-KR
 title: 자기 자신을 닫는 태그
 layout: tips
-permalink: self-closing-tag-ko-KR.html
+permalink: tips/self-closing-tag-ko-KR.html
 prev: if-else-in-JSX-ko-KR.html
 next: maximum-number-of-jsx-root-nodes-ko-KR.html
 ---
diff --git a/tips/04-self-closing-tag.md b/tips/04-self-closing-tag.md
index 7c0a72fa8..3fb9d96c6 100644
--- a/tips/04-self-closing-tag.md
+++ b/tips/04-self-closing-tag.md
@@ -2,7 +2,7 @@
 id: self-closing-tag
 title: Self-Closing Tag
 layout: tips
-permalink: self-closing-tag.html
+permalink: tips/self-closing-tag.html
 prev: if-else-in-JSX.html
 next: maximum-number-of-jsx-root-nodes.html
 ---
diff --git a/tips/05-maximum-number-of-jsx-root-nodes.ko-KR.md b/tips/05-maximum-number-of-jsx-root-nodes.ko-KR.md
index d5288104a..687390017 100644
--- a/tips/05-maximum-number-of-jsx-root-nodes.ko-KR.md
+++ b/tips/05-maximum-number-of-jsx-root-nodes.ko-KR.md
@@ -2,7 +2,7 @@
 id: maximum-number-of-jsx-root-nodes-ko-KR
 title: JSX 루트 노드의 최대 갯수
 layout: tips
-permalink: maximum-number-of-jsx-root-nodes-ko-KR.html
+permalink: tips/maximum-number-of-jsx-root-nodes-ko-KR.html
 prev: self-closing-tag-ko-KR.html
 next: style-props-value-px-ko-KR.html
 ---
diff --git a/tips/05-maximum-number-of-jsx-root-nodes.md b/tips/05-maximum-number-of-jsx-root-nodes.md
index d3e026f70..0ab938a0d 100644
--- a/tips/05-maximum-number-of-jsx-root-nodes.md
+++ b/tips/05-maximum-number-of-jsx-root-nodes.md
@@ -2,7 +2,7 @@
 id: maximum-number-of-jsx-root-nodes
 title: Maximum Number of JSX Root Nodes
 layout: tips
-permalink: maximum-number-of-jsx-root-nodes.html
+permalink: tips/maximum-number-of-jsx-root-nodes.html
 prev: self-closing-tag.html
 next: style-props-value-px.html
 ---
diff --git a/tips/06-style-props-value-px.ko-KR.md b/tips/06-style-props-value-px.ko-KR.md
index a955afc8f..312278945 100644
--- a/tips/06-style-props-value-px.ko-KR.md
+++ b/tips/06-style-props-value-px.ko-KR.md
@@ -2,7 +2,7 @@
 id: style-props-value-px-ko-KR
 title: 스타일 속성에서 특정 픽셀 값 넣는 간단한 방법 
 layout: tips
-permalink: style-props-value-px-ko-KR.html
+permalink: tips/style-props-value-px-ko-KR.html
 prev: maximum-number-of-jsx-root-nodes-ko-KR.html
 next: children-props-type-ko-KR.html
 ---
diff --git a/tips/06-style-props-value-px.md b/tips/06-style-props-value-px.md
index 02473a08e..fa7c5ccfa 100644
--- a/tips/06-style-props-value-px.md
+++ b/tips/06-style-props-value-px.md
@@ -2,7 +2,7 @@
 id: style-props-value-px
 title: Shorthand for Specifying Pixel Values in style props
 layout: tips
-permalink: style-props-value-px.html
+permalink: tips/style-props-value-px.html
 prev: maximum-number-of-jsx-root-nodes.html
 next: children-props-type.html
 ---
diff --git a/tips/07-children-props-type.ko-KR.md b/tips/07-children-props-type.ko-KR.md
index ee8a3d48b..d5576ff26 100644
--- a/tips/07-children-props-type.ko-KR.md
+++ b/tips/07-children-props-type.ko-KR.md
@@ -2,7 +2,7 @@
 id: children-props-type-ko-KR
 title: 자식 속성들의 타입
 layout: tips
-permalink: children-props-type-ko-KR.html
+permalink: tips/children-props-type-ko-KR.html
 prev: style-props-value-px-ko-KR.html
 next: controlled-input-null-value-ko-KR.html
 ---
diff --git a/tips/07-children-props-type.md b/tips/07-children-props-type.md
index 3785ae898..7f781a374 100644
--- a/tips/07-children-props-type.md
+++ b/tips/07-children-props-type.md
@@ -2,7 +2,7 @@
 id: children-props-type
 title: Type of the Children props
 layout: tips
-permalink: children-props-type.html
+permalink: tips/children-props-type.html
 prev: style-props-value-px.html
 next: controlled-input-null-value.html
 ---
diff --git a/tips/08-controlled-input-null-value.ko-KR.md b/tips/08-controlled-input-null-value.ko-KR.md
index a9c754d6c..0c757748d 100644
--- a/tips/08-controlled-input-null-value.ko-KR.md
+++ b/tips/08-controlled-input-null-value.ko-KR.md
@@ -2,7 +2,7 @@
 id: controlled-input-null-value-ko-KR
 title: 제어되는 input 내의 null 값
 layout: tips
-permalink: controlled-input-null-value-ko-KR.html
+permalink: tips/controlled-input-null-value-ko-KR.html
 prev: children-props-type-ko-KR.html
 next: componentWillReceiveProps-not-triggered-after-mounting-ko-KR.html
 ---
diff --git a/tips/08-controlled-input-null-value.md b/tips/08-controlled-input-null-value.md
index 55b88eff9..3f3f2f510 100644
--- a/tips/08-controlled-input-null-value.md
+++ b/tips/08-controlled-input-null-value.md
@@ -2,7 +2,7 @@
 id: controlled-input-null-value
 title: Value of null for Controlled Input
 layout: tips
-permalink: controlled-input-null-value.html
+permalink: tips/controlled-input-null-value.html
 prev: children-props-type.html
 next: componentWillReceiveProps-not-triggered-after-mounting.html
 ---
diff --git a/tips/09-componentWillReceiveProps-not-triggered-after-mounting.ko-KR.md b/tips/09-componentWillReceiveProps-not-triggered-after-mounting.ko-KR.md
index bbee76b3f..ccbf5eadb 100644
--- a/tips/09-componentWillReceiveProps-not-triggered-after-mounting.ko-KR.md
+++ b/tips/09-componentWillReceiveProps-not-triggered-after-mounting.ko-KR.md
@@ -2,7 +2,7 @@
 id: componentWillReceiveProps-not-triggered-after-mounting-ko-KR
 title: 마운트 후에는 componentWillReceiveProps가 실행되지 않음.
 layout: tips
-permalink: componentWillReceiveProps-not-triggered-after-mounting-ko-KR.html
+permalink: tips/componentWillReceiveProps-not-triggered-after-mounting-ko-KR.html
 prev: controlled-input-null-value-ko-KR.html
 next: props-in-getInitialState-as-anti-pattern-ko-KR.html
 ---
diff --git a/tips/09-componentWillReceiveProps-not-triggered-after-mounting.md b/tips/09-componentWillReceiveProps-not-triggered-after-mounting.md
index b4b1cd5c1..089b7cd29 100644
--- a/tips/09-componentWillReceiveProps-not-triggered-after-mounting.md
+++ b/tips/09-componentWillReceiveProps-not-triggered-after-mounting.md
@@ -2,7 +2,7 @@
 id: componentWillReceiveProps-not-triggered-after-mounting
 title: componentWillReceiveProps Not Triggered After Mounting
 layout: tips
-permalink: componentWillReceiveProps-not-triggered-after-mounting.html
+permalink: tips/componentWillReceiveProps-not-triggered-after-mounting.html
 prev: controlled-input-null-value.html
 next: props-in-getInitialState-as-anti-pattern.html
 ---
diff --git a/tips/10-props-in-getInitialState-as-anti-pattern.ko-KR.md b/tips/10-props-in-getInitialState-as-anti-pattern.ko-KR.md
index 942ace67a..7831cb6a0 100644
--- a/tips/10-props-in-getInitialState-as-anti-pattern.ko-KR.md
+++ b/tips/10-props-in-getInitialState-as-anti-pattern.ko-KR.md
@@ -2,7 +2,7 @@
 id: props-in-getInitialState-as-anti-pattern-ko-KR
 title: getInitialState의 Props는 안티패턴
 layout: tips
-permalink: props-in-getInitialState-as-anti-pattern-ko-KR.html
+permalink: tips/props-in-getInitialState-as-anti-pattern-ko-KR.html
 prev: componentWillReceiveProps-not-triggered-after-mounting-ko-KR.html
 next: dom-event-listeners-ko-KR.html
 ---
diff --git a/tips/10-props-in-getInitialState-as-anti-pattern.md b/tips/10-props-in-getInitialState-as-anti-pattern.md
index 70b41bf95..579035d2d 100644
--- a/tips/10-props-in-getInitialState-as-anti-pattern.md
+++ b/tips/10-props-in-getInitialState-as-anti-pattern.md
@@ -2,7 +2,7 @@
 id: props-in-getInitialState-as-anti-pattern
 title: Props in getInitialState Is an Anti-Pattern
 layout: tips
-permalink: props-in-getInitialState-as-anti-pattern.html
+permalink: tips/props-in-getInitialState-as-anti-pattern.html
 prev: componentWillReceiveProps-not-triggered-after-mounting.html
 next: dom-event-listeners.html
 ---
diff --git a/tips/11-dom-event-listeners.ko-KR.md b/tips/11-dom-event-listeners.ko-KR.md
index 527765551..a622df160 100644
--- a/tips/11-dom-event-listeners.ko-KR.md
+++ b/tips/11-dom-event-listeners.ko-KR.md
@@ -2,7 +2,7 @@
 id: dom-event-listeners-ko-KR
 title: 컴포넌트에서 DOM 이벤트 리스너
 layout: tips
-permalink: dom-event-listeners-ko-KR.html
+permalink: tips/dom-event-listeners-ko-KR.html
 prev: props-in-getInitialState-as-anti-pattern-ko-KR.html
 next: initial-ajax-ko-KR.html
 ---
diff --git a/tips/11-dom-event-listeners.md b/tips/11-dom-event-listeners.md
index 141ec0b97..efe0eeb0e 100644
--- a/tips/11-dom-event-listeners.md
+++ b/tips/11-dom-event-listeners.md
@@ -2,7 +2,7 @@
 id: dom-event-listeners
 title: DOM Event Listeners in a Component
 layout: tips
-permalink: dom-event-listeners.html
+permalink: tips/dom-event-listeners.html
 prev: props-in-getInitialState-as-anti-pattern.html
 next: initial-ajax.html
 ---
diff --git a/tips/12-initial-ajax.ko-KR.md b/tips/12-initial-ajax.ko-KR.md
index 3e2b5a50f..33dbe002b 100644
--- a/tips/12-initial-ajax.ko-KR.md
+++ b/tips/12-initial-ajax.ko-KR.md
@@ -2,7 +2,7 @@
 id: initial-ajax-ko-KR
 title: AJAX를 통해 초기 데이터 읽어오기
 layout: tips
-permalink: initial-ajax-ko-KR.html
+permalink: tips/initial-ajax-ko-KR.html
 prev: dom-event-listeners-ko-KR.html
 next: false-in-jsx-ko-KR.html
 ---
diff --git a/tips/12-initial-ajax.md b/tips/12-initial-ajax.md
index e8d4c960a..61ce22e44 100644
--- a/tips/12-initial-ajax.md
+++ b/tips/12-initial-ajax.md
@@ -2,7 +2,7 @@
 id: initial-ajax
 title: Load Initial Data via AJAX
 layout: tips
-permalink: initial-ajax.html
+permalink: tips/initial-ajax.html
 prev: dom-event-listeners.html
 next: false-in-jsx.html
 ---
diff --git a/tips/13-false-in-jsx.ko-KR.md b/tips/13-false-in-jsx.ko-KR.md
index fddb6dcca..24d03e656 100644
--- a/tips/13-false-in-jsx.ko-KR.md
+++ b/tips/13-false-in-jsx.ko-KR.md
@@ -2,7 +2,7 @@
 id: false-in-jsx-ko-KR
 title: JSX에서 False
 layout: tips
-permalink: false-in-jsx-ko-KR.html
+permalink: tips/false-in-jsx-ko-KR.html
 prev: initial-ajax-ko-KR.html
 next: communicate-between-components-ko-KR.html
 ---
diff --git a/tips/13-false-in-jsx.md b/tips/13-false-in-jsx.md
index 144b91e08..8727fdecb 100644
--- a/tips/13-false-in-jsx.md
+++ b/tips/13-false-in-jsx.md
@@ -2,7 +2,7 @@
 id: false-in-jsx
 title: False in JSX
 layout: tips
-permalink: false-in-jsx.html
+permalink: tips/false-in-jsx.html
 prev: initial-ajax.html
 next: communicate-between-components.html
 ---
diff --git a/tips/14-communicate-between-components.ko-KR.md b/tips/14-communicate-between-components.ko-KR.md
index 7feb6864d..3c42d71cd 100644
--- a/tips/14-communicate-between-components.ko-KR.md
+++ b/tips/14-communicate-between-components.ko-KR.md
@@ -2,7 +2,7 @@
 id: communicate-between-components-ko-KR
 title: 컴포넌트간의 통신
 layout: tips
-permalink: communicate-between-components-ko-KR.html
+permalink: tips/communicate-between-components-ko-KR.html
 prev: false-in-jsx-ko-KR.html
 next: expose-component-functions-ko-KR.html
 ---
diff --git a/tips/14-communicate-between-components.md b/tips/14-communicate-between-components.md
index 3038be7cc..0db0d63ad 100644
--- a/tips/14-communicate-between-components.md
+++ b/tips/14-communicate-between-components.md
@@ -2,7 +2,7 @@
 id: communicate-between-components
 title: Communicate Between Components
 layout: tips
-permalink: communicate-between-components.html
+permalink: tips/communicate-between-components.html
 prev: false-in-jsx.html
 next: expose-component-functions.html
 ---
diff --git a/tips/15-expose-component-functions.ko-KR.md b/tips/15-expose-component-functions.ko-KR.md
index 0648961b1..153b61414 100644
--- a/tips/15-expose-component-functions.ko-KR.md
+++ b/tips/15-expose-component-functions.ko-KR.md
@@ -2,7 +2,7 @@
 id: expose-component-functions-ko-KR
 title: 컴포넌트 함수 드러내기
 layout: tips
-permalink: expose-component-functions-ko-KR.html
+permalink: tips/expose-component-functions-ko-KR.html
 prev: communicate-between-components-ko-KR.html
 next: children-undefined-ko-KR.html
 ---
diff --git a/tips/15-expose-component-functions.md b/tips/15-expose-component-functions.md
index 7eaadb366..90278b740 100644
--- a/tips/15-expose-component-functions.md
+++ b/tips/15-expose-component-functions.md
@@ -2,7 +2,7 @@
 id: expose-component-functions
 title: Expose Component Functions
 layout: tips
-permalink: expose-component-functions.html
+permalink: tips/expose-component-functions.html
 prev: communicate-between-components.html
 next: children-undefined.html
 ---
diff --git a/tips/16-references-to-components.ko-KR.md b/tips/16-references-to-components.ko-KR.md
index 3e9058a98..cd216e827 100644
--- a/tips/16-references-to-components.ko-KR.md
+++ b/tips/16-references-to-components.ko-KR.md
@@ -2,7 +2,7 @@
 id: references-to-components-ko-KR
 title: 컴포넌트 참조
 layout: tips
-permalink: references-to-components-ko-KR.html
+permalink: tips/references-to-components-ko-KR.html
 prev: expose-component-functions-ko-KR.html
 next: children-undefined-ko-KR.html
 ---
diff --git a/tips/16-references-to-components.md b/tips/16-references-to-components.md
index b0e1e5744..5f2ef002e 100644
--- a/tips/16-references-to-components.md
+++ b/tips/16-references-to-components.md
@@ -2,7 +2,7 @@
 id: references-to-components
 title: References to Components
 layout: tips
-permalink: references-to-components.html
+permalink: tips/references-to-components.html
 prev: expose-component-functions.html
 next: children-undefined.html
 ---
diff --git a/tips/17-children-undefined.ko-KR.md b/tips/17-children-undefined.ko-KR.md
index 8b795734d..3590b4b87 100644
--- a/tips/17-children-undefined.ko-KR.md
+++ b/tips/17-children-undefined.ko-KR.md
@@ -2,7 +2,7 @@
 id: children-undefined-ko-KR
 title: 정의되지 않은 this.props.children
 layout: tips
-permalink: children-undefined-ko-KR.html
+permalink: tips/children-undefined-ko-KR.html
 prev: expose-component-functions-ko-KR.html
 next: use-react-with-other-libraries-ko-KR.html
 ---
diff --git a/tips/17-children-undefined.md b/tips/17-children-undefined.md
index fb29c2f5b..a0e461b84 100644
--- a/tips/17-children-undefined.md
+++ b/tips/17-children-undefined.md
@@ -2,7 +2,7 @@
 id: children-undefined
 title: this.props.children undefined
 layout: tips
-permalink: children-undefined.html
+permalink: tips/children-undefined.html
 prev: expose-component-functions.html
 next: use-react-with-other-libraries.html
 ---
diff --git a/tips/18-use-react-with-other-libraries.ko-KR.md b/tips/18-use-react-with-other-libraries.ko-KR.md
index 9dfd1d46c..d4161e717 100644
--- a/tips/18-use-react-with-other-libraries.ko-KR.md
+++ b/tips/18-use-react-with-other-libraries.ko-KR.md
@@ -2,7 +2,7 @@
 id: use-react-with-other-libraries-ko-KR
 title: React와 다른 라이브러리를 함께 사용하기
 layout: tips
-permalink: use-react-with-other-libraries-ko-KR.html
+permalink: tips/use-react-with-other-libraries-ko-KR.html
 prev: children-undefined-ko-KR.html
 next: dangerously-set-inner-html-ko-KR.html
 ---
diff --git a/tips/18-use-react-with-other-libraries.md b/tips/18-use-react-with-other-libraries.md
index fc5634fa8..b93f41848 100644
--- a/tips/18-use-react-with-other-libraries.md
+++ b/tips/18-use-react-with-other-libraries.md
@@ -2,7 +2,7 @@
 id: use-react-with-other-libraries
 title: Use React with Other Libraries
 layout: tips
-permalink: use-react-with-other-libraries.html
+permalink: tips/use-react-with-other-libraries.html
 prev: children-undefined.html
 next: dangerously-set-inner-html.html
 ---
diff --git a/tips/19-dangerously-set-inner-html.ko-KR.md b/tips/19-dangerously-set-inner-html.ko-KR.md
index a5c920005..8cdf522a7 100644
--- a/tips/19-dangerously-set-inner-html.ko-KR.md
+++ b/tips/19-dangerously-set-inner-html.ko-KR.md
@@ -2,7 +2,7 @@
 id: dangerously-set-inner-html-ko-KR
 title: Dangerously Set innerHTML
 layout: tips
-permalink: dangerously-set-inner-html-ko-KR.html
+permalink: tips/dangerously-set-inner-html-ko-KR.html
 prev: children-undefined-ko-KR.html
 ---
 
diff --git a/tips/19-dangerously-set-inner-html.md b/tips/19-dangerously-set-inner-html.md
index f580f5d08..9f81ebc83 100644
--- a/tips/19-dangerously-set-inner-html.md
+++ b/tips/19-dangerously-set-inner-html.md
@@ -2,7 +2,7 @@
 id: dangerously-set-inner-html
 title: Dangerously Set innerHTML
 layout: tips
-permalink: dangerously-set-inner-html.html
+permalink: tips/dangerously-set-inner-html.html
 prev: children-undefined.html
 ---