Documentation Restructure

.vuepress/config.js

@@ -11,128 +11,145 @@ module.exports = {
     sidebarDepth: 1,
     smoothScroll: true,
     nav: [
-      { text: 'Guides', link: '/guides/' },
-      { text: 'API References', link: '/references/' },
-      { text: 'Resources', link: '/resources/' },
-      { text: 'FAQ', link: '/faq/' },
+      { text: 'Learn', link: '/learn/' },
+      { text: 'Create', link: '/create/' },
+      { text: 'Reference', link: '/reference/' },
       { text: 'Slack', link: 'https://slack.meilisearch.com' },
     ],
     sidebar: {
-      '/guides/': [
+      '/learn/': [
         {
-          title: '🚀 Introduction',
-          path: '/guides/introduction/',
+          title: '🔎 What Is MeiliSearch?',
+          path: '/learn/what_is_meilisearch/',
           collapsable: false,
           children: [
-            '/guides/introduction/quick_start_guide',
-            '/guides/introduction/whats_next',
+            '/learn/what_is_meilisearch/features',
+            '/learn/what_is_meilisearch/philosophy',
+            '/learn/what_is_meilisearch/sdks',
+            '/learn/what_is_meilisearch/comparison_to_alternatives',
+            '/learn/what_is_meilisearch/contact',
           ],
         },
         {
-          title: '💡 Main concepts',
-          path: '/guides/main_concepts/',
+          title: '🚀 Tutorials',
+          path: '/learn/tutorials/',
           collapsable: false,
           children: [
-            '/guides/main_concepts/indexes',
-            '/guides/main_concepts/documents',
-            '/guides/main_concepts/search',
-            '/guides/main_concepts/relevancy',
+            '/learn/tutorials/getting_started',
+            '/learn/tutorials/whats_next',
           ],
         },
         {
-          title: '📚 Advanced Guides',
-          path: '/guides/advanced_guides/',
+          title: '💡 Core Concepts',
+          path: '/learn/core_concepts/',
           collapsable: false,
           children: [
-            '/guides/advanced_guides/installation',
-            '/guides/advanced_guides/configuration',
-            '/guides/advanced_guides/search_parameters',
-            '/guides/advanced_guides/filtering',
-            '/guides/advanced_guides/faceted_search',
-            '/guides/advanced_guides/authentication',
-            '/guides/advanced_guides/asynchronous_updates',
-            '/guides/advanced_guides/web_interface',
-            '/guides/advanced_guides/datatypes',
-            '/guides/advanced_guides/settings',
-            '/guides/advanced_guides/synonyms',
-            '/guides/advanced_guides/stop_words',
-            '/guides/advanced_guides/distinct',
-            '/guides/advanced_guides/snapshots_and_dumps',
-            '/guides/advanced_guides/field_properties',
-            '/guides/advanced_guides/typotolerance',
-            '/guides/advanced_guides/prefix',
-            '/guides/advanced_guides/concat',
-            '/guides/advanced_guides/bucket_sort',
-            '/guides/advanced_guides/known_limitations',
-            '/guides/advanced_guides/tokenization',
+            '/learn/core_concepts/documents',
+            '/learn/core_concepts/indexes',
+            '/learn/core_concepts/relevancy',
+          ],
+        },
+        {
+          title: '📚 Advanced Topics',
+          path: '/learn/advanced/',
+          collapsable: false,
+          children: [
+            '/learn/advanced/language',
+            '/learn/advanced/asynchronous_updates',
+            '/learn/advanced/snapshots_vs_dumps',
           ],
         },
       ],
-      '/references/': [
+      '/reference/': [
+        {
+          title: '⭐ Feature References',
+          path: '/reference/features/',
+          collapsable: true,
+          children: [
+            '/reference/features/authentication',
+            '/reference/features/configuration',
+            '/reference/features/distinct',
+            '/reference/features/dumps',
+            '/reference/features/faceted_search',
+            '/reference/features/field_properties',
+            '/reference/features/filtering',
+            '/reference/features/installation',
+            '/reference/features/known_limitations',
+            '/reference/features/search_parameters',
+            '/reference/features/settings',
+            '/reference/features/snapshots',
+            '/reference/features/stop_words',
+            '/reference/features/synonyms',
+            '/reference/features/web_interface',
+          ],
+        },
         {
           title: '📒 API References',
-          path: '/references/',
-          collapsable: false,
+          path: '/reference/api/',
+          collapsable: true,
           children: [
-            '/references/indexes',
-            '/references/documents',
-            '/references/search',
-            '/references/updates',
-            '/references/keys',
+            '/reference/api/indexes',
+            '/reference/api/documents',
+            '/reference/api/search',
+            '/reference/api/updates',
+            '/reference/api/keys',
             {
               title: 'Settings',
-              path: '/references/settings/',
+              path: '/reference/api/settings/',
               collapsable: false,
               children: [
                 {
                   title: 'All Settings',
-                  path: '/references/settings',
+                  path: '/reference/api/settings',
                 },
-                '/references/synonyms',
-                '/references/stop_words',
-                '/references/ranking_rules',
-                '/references/attributes_for_faceting',
-                '/references/distinct_attribute',
-                '/references/searchable_attributes',
-                '/references/displayed_attributes',
+                '/reference/api/synonyms',
+                '/reference/api/stop_words',
+                '/reference/api/ranking_rules',
+                '/reference/api/attributes_for_faceting',
+                '/reference/api/distinct_attribute',
+                '/reference/api/searchable_attributes',
+                '/reference/api/displayed_attributes',
               ],
             },
-            '/references/stats',
-            '/references/health',
-            '/references/version',
-            '/references/dump',
+            '/reference/api/stats',
+            '/reference/api/health',
+            '/reference/api/version',
+            '/reference/api/dump',
           ],
         },
-      ],
-      '/resources/': [
         {
-          title: '📦 Resources',
-          path: '/resources/',
-          collapsable: false,
+          title: '🛠️ Under the Hood',
+          path: '/reference/under_the_hood/',
+          collapsable: true,
           children: [
-            '/resources/about_storage',
-            '/resources/sdks',
-            '/resources/comparison_to_alternatives',
-            '/resources/postman_collection',
-            '/resources/contact',
+            '/reference/under_the_hood/bucket_sort',
+            '/reference/under_the_hood/concat',
+            '/reference/under_the_hood/datatypes',
+            '/reference/under_the_hood/prefix',
+            '/reference/under_the_hood/storage',
+            '/reference/under_the_hood/tokenization',
+            '/reference/under_the_hood/typotolerance',
           ],
         },
+      ],
+      '/create/': [
         {
-          title: '🏆 Tutorials',
-          path: '/resources/tutorials/',
+          title: '📜 How To',
+          path: '/create/how_to/',
           collapsable: false,
-          children: ['/resources/tutorials/running_production'],
+          children: [
+            '/create/how_to/running_production',
+            '/create/how_to/search_bar_for_docs',
+            '/create/how_to/digitalocean_droplet',
+            '/create/how_to/http2_ssl',
+            '/create/how_to/postman_collection',
+            '/create/how_to/meilisearch_react',
+          ],
         },
         {
-          title: "🧷 How to's",
-          path: '/resources/howtos/',
+          title: '❓ FAQ',
+          path: '/create/faq',
           collapsable: false,
-          children: [
-            '/resources/howtos/meilisearch_react',
-            '/resources/howtos/digitalocean_droplet',
-            '/resources/howtos/search_bar_for_docs',
-            '/resources/howtos/http2_ssl',
-          ],
         },
       ],
     },

create/README.md

@@ -0,0 +1,16 @@
+# Create with MeiliSearch
+
+Want to create a brilliant website, app, or other project with MeiliSearch? You've come to the right place.
+
+This section covers everything you need to bring your project from idea to completion.
+
+## Table of Contents
+
+- [📜 How To](/create/how_to): Step-by-step guides for efficient problem-solving
+  - [Run MeiliSearch in Production](/create/how_to/running_production.md)
+  - [Integrate a Relevant Search Bar to Your Documentation](/create/how_to/search_bar_for_docs.md)
+  - [Deploy MeiliSearch on DigitalOcean](/create/how_to/digitalocean_droplet.md)
+  - [Use HTTP/2 and SSL with MeiliSearch](/create/how_to/http2_ssl.md)
+  - [Use Postman with MeiliSearch](/create/how_to/postman_collection.md)
+  - [Implement Instant Search in Your React App in 5 Minutes](/create/how_to/meilisearch_react.md)
+- [❓ FAQ](/create/faq.md): Frequently Asked Questions