From c2c1e635b6c0f5ef7dbe9f9134fff2a6d6a855e9 Mon Sep 17 00:00:00 2001
From: Wei Gao <wgao19@gmail.com>
Date: Thu, 18 Jul 2019 08:44:36 +0800
Subject: [PATCH 1/2] docs(v2): subcategories

---
 website/docs/sidebar.md | 35 +++++++++++++++++++++++++++++------
 1 file changed, 29 insertions(+), 6 deletions(-)

diff --git a/website/docs/sidebar.md b/website/docs/sidebar.md
index 6c89319140c0..e8b8af53652c 100644
--- a/website/docs/sidebar.md
+++ b/website/docs/sidebar.md
@@ -33,13 +33,36 @@ The `docs` key in the exported object is just the name of that particular sideba
 
 ## Subcategories
 
-_This section is a work in progress. [Welcoming PRs](https://github.com/facebook/docusaurus/issues/1640)._
+To include subcategories in docs sidebar, use an object of the following shape
 
-<!--
+```js
+{
+  type: 'category',
+  label: string, // sidebar label
+  items: string[], // string of doc ids
+}
+```
 
-Note: We're implementing a new sidebar, this following links to the legacy sidebar as a reference
-[source code](packages/docusaurus-theme-classic/src/theme/DocLegacySidebar/index.js)
+in place of a string of id. As an example, here's how we created the subcategory for "Docs" under "Guides" in this site:
 
-If you are interested in this section, please follow up on our progress
+```jsx
+// sidebars.js
+module.exports = {
+  docs: {
+    Guides: [
+      'creating-pages',
+      {
+        type: 'category',
+        label: 'Docs',
+        items: ['markdown-features', 'sidebar'],
+      },
+    ],
+  },
+};
+```
+
+**Note**: Only one layer of nestedness is allowed.
 
--->
+**Note**: We're implementing a new sidebar!
+
+_This section is a work in progress. [Welcoming PRs](https://github.com/facebook/docusaurus/issues/1640)._

From 29b5a6d2ba6e371ff508811c2bbf81ef846c32bf Mon Sep 17 00:00:00 2001
From: Wei Gao <wgao19@gmail.com>
Date: Thu, 18 Jul 2019 09:56:00 +0800
Subject: [PATCH 2/2] fix a typo and move call for pr to a comment till new
 side bar is implemented

---
 website/docs/sidebar.md | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/website/docs/sidebar.md b/website/docs/sidebar.md
index e8b8af53652c..cdfb0c9db449 100644
--- a/website/docs/sidebar.md
+++ b/website/docs/sidebar.md
@@ -39,7 +39,7 @@ To include subcategories in docs sidebar, use an object of the following shape
 {
   type: 'category',
   label: string, // sidebar label
-  items: string[], // string of doc ids
+  items: string[], // strings of doc ids
 }
 ```
 
@@ -65,4 +65,8 @@ module.exports = {
 
 **Note**: We're implementing a new sidebar!
 
+<!--
+
 _This section is a work in progress. [Welcoming PRs](https://github.com/facebook/docusaurus/issues/1640)._
+
+-->