Upgrade doc

doc/blog/2024-07-21-welcome/index.md

@@ -7,6 +7,8 @@ tags: [hello]
 
 Welcome! I've embarked on an exciting journey to explore how Docusaurus can be used to document OCaml projects, while seamlessly integrating with OCaml's dedicated tools like dune, odoc, and ocaml-mdx.
 
+<!-- truncate -->
+
 This exploration aims to culminate in a template or a simple example that showcases the dynamic capabilities of combining these tools. It's a work in progress, and I'm eager to dive deeper into the features, seeking to enrich this experiment with community feedback and collaboration.
 
 I'm thrilled to have initiated this repository, creating a space for incremental progress and sharing insights with fellow Docusaurus and OCaml enthusiasts.

doc/docs/explanation/README.md

@@ -0,0 +1,3 @@
+# Explanation
+
+Welcome to the Explanation section of the documentation. Here, we delve into the details of how the project works, its design principles, and our future plans. This section is intended to provide a deeper understanding of the project for developers and contributors.

doc/docs/guides/README.md

@@ -0,0 +1,3 @@
+# Introduction
+
+This part of the documentation is currently empty.

doc/docusaurus.config.ts

@@ -73,17 +73,29 @@ const config: Config = {
       items: [
         {
           type: 'docSidebar',
-          sidebarId: 'odocSidebar',
+          sidebarId: 'tutorialsSidebar',
           position: 'left',
-          label: 'OCaml Packages',
+          label: 'Tutorials',
         },
         {
           type: 'docSidebar',
-          sidebarId: 'mylibSidebar',
+          sidebarId: 'guidesSidebar',
           position: 'left',
-          label: 'Mylib',
+          label: 'Guides',
         },
-        { to: '/blog/', label: 'Blog', position: 'left' },
+        {
+          type: 'docSidebar',
+          sidebarId: 'referenceSidebar',
+          position: 'left',
+          label: 'Reference',
+        },
+        {
+          type: 'docSidebar',
+          sidebarId: 'explanationSidebar',
+          position: 'left',
+          label: 'Explanation',
+        },
+        { to: '/blog/', label: 'Blog', position: 'right' },
         {
           href: 'https://github.com/mbarbin/doc-experiment-docusaurus',
           label: 'GitHub',
@@ -104,12 +116,20 @@ const config: Config = {
           title: 'Docs',
           items: [
             {
-              label: 'OCaml Packages',
-              to: '/docs/odoc/',
+              label: 'Tutorials',
+              to: '/docs/tutorials/hello-mylib/',
+            },
+            {
+              label: 'Guides',
+              to: '/docs/guides/',
+            },
+            {
+              label: 'Reference',
+              to: '/docs/reference/odoc/',
             },
             {
-              label: 'Mylib',
-              to: '/docs/mylib/hello_mylib/',
+              label: 'Explanation',
+              to: '/docs/explanation/',
             },
           ],
         },