add documentation regarding usage of nested docs + git ignore .idea (#…

…860)

* add documentation regarding usage of nested docs + add .idea in .gitignore

* Remove 1.3.3, move to navigation & simplify wording

* add documentation for docusaurus >= v1.2.0 a well

.gitignore

@@ -1,5 +1,6 @@
 .DS_Store
 .vscode
+.idea
 *.code-workspace
 
 node_modules

docs/guides-navigation.md

@@ -72,6 +72,28 @@ Or you can create a new category within the sidebar:
 }
 ```
 
+However, for a document located in a docs subdirectory like below:
+
+```bash
+docs
+└── dir1
+    └── getting-started.md
+```
+
+You should provide `directory/id` instead of `id` in `sidebars.json`.
+
+```js
+{
+  "docs": {
+    "My New Sidebar Category": [
+      "dir1/getting-started"
+    ],
+    ...
+  },
+  ...
+}
+```
+
 ### Adding New Sidebars
 
 You can also put a document in a new sidebar. In the following example, we are creating an `examples-sidebar` sidebar within `sidebars.json` that has a category called `My Example Category` containing a document with an `id` of `my-examples`.

website/versioned_docs/version-1.2.0/guides-navigation.md

@@ -73,6 +73,28 @@ Or you can create a new category within the sidebar:
 }
 ```
 
+However, for a document located in a docs subdirectory like below:
+
+```bash
+docs
+└── dir1
+    └── getting-started.md
+```
+
+You should provide `directory/id` instead of `id` in `sidebars.json`.
+
+```js
+{
+  "docs": {
+    "My New Sidebar Category": [
+      "dir1/getting-started"
+    ],
+    ...
+  },
+  ...
+}
+```
+
 ### Adding New Sidebars
 
 You can also put a document in a new sidebar. In the following example, we are creating an `examples-sidebar` sidebar within `sidebars.json` that has a category called `My Example Category` containing a document with an `id` of `my-examples`.