Split into 3 separate doc sites: /knowledge, /spec, /bluematter

prasad-kumkar · prasad-kumkar · commit 55bc6c1dcc14 · 2026-03-14T00:11:44.000+05:30
diff --git a/bluematter-arch/call-flows.md b/bluematter-arch/call-flows.md
@@ -1,3 +1,5 @@
+---
+---
 # Call Flows
 
 Every function call in the main sync path, traced from CLI entry to disk write.
diff --git a/bluematter-arch/codec.md b/bluematter-arch/codec.md
@@ -1,3 +1,5 @@
+---
+---
 # Codec
 
 ## Overview
diff --git a/bluematter-arch/consensus.md b/bluematter-arch/consensus.md
@@ -1,3 +1,5 @@
+---
+---
 # Consensus
 
 ## Overview
diff --git a/bluematter-arch/crypto.md b/bluematter-arch/crypto.md
@@ -1,3 +1,5 @@
+---
+---
 # Crypto
 
 ## Overview
diff --git a/bluematter-arch/ledger.md b/bluematter-arch/ledger.md
@@ -1,3 +1,5 @@
+---
+---
 # Ledger
 
 ## Overview
diff --git a/bluematter-arch/network.md b/bluematter-arch/network.md
@@ -1,3 +1,5 @@
+---
+---
 # Network
 
 ## Overview
diff --git a/bluematter-arch/node.md b/bluematter-arch/node.md
@@ -1,3 +1,5 @@
+---
+---
 # Node
 
 ## Overview
diff --git a/bluematter-arch/overview.md b/bluematter-arch/overview.md
@@ -1,3 +1,5 @@
+---
+---
 # Overview
 
 Bluematter is an independent Cardano full-node implementation in pure Python.
diff --git a/docusaurus.config.ts b/docusaurus.config.ts
@@ -5,7 +5,7 @@ import remarkMath from 'remark-math';
 import rehypeKatex from 'rehype-katex';
 
 const config: Config = {
-  title: 'Bluematter',
+  title: 'BlueMatter',
   tagline: 'Cardano Node Implementation',
   favicon: 'img/favicon.ico',
 
@@ -50,23 +50,50 @@ const config: Config = {
       'classic',
       {
         docs: {
-          sidebarPath: './sidebars.ts',
-          routeBasePath: '/docs',
+          id: 'knowledge',
+          path: 'knowledge-base',
+          routeBasePath: '/knowledge',
+          sidebarPath: './sidebarsKnowledge.ts',
           remarkPlugins: [remarkMath],
           rehypePlugins: [rehypeKatex],
         },
+        blog: false,
         pages: {
           remarkPlugins: [remarkMath],
           rehypePlugins: [rehypeKatex],
         },
-        blog: false,
         theme: {
           customCss: './src/css/custom.css',
         },
       } satisfies Preset.Options,
     ],
   ],
 
+  plugins: [
+    [
+      '@docusaurus/plugin-content-docs',
+      {
+        id: 'specification',
+        path: 'specification',
+        routeBasePath: '/spec',
+        sidebarPath: './sidebarsSpec.ts',
+        remarkPlugins: [remarkMath],
+        rehypePlugins: [rehypeKatex],
+      },
+    ],
+    [
+      '@docusaurus/plugin-content-docs',
+      {
+        id: 'bluematter',
+        path: 'bluematter-arch',
+        routeBasePath: '/bluematter',
+        sidebarPath: './sidebarsArch.ts',
+        remarkPlugins: [remarkMath],
+        rehypePlugins: [rehypeKatex],
+      },
+    ],
+  ],
+
   themeConfig: {
     colorMode: {
       respectPrefersColorScheme: true,
@@ -75,10 +102,19 @@ const config: Config = {
       title: 'BlueMatter',
       items: [
         {
-          type: 'docSidebar',
-          sidebarId: 'specSidebar',
+          to: '/knowledge/intro',
+          label: 'Knowledge Base',
+          position: 'left',
+        },
+        {
+          to: '/spec/notation',
+          label: 'Specification',
+          position: 'left',
+        },
+        {
+          to: '/bluematter/overview',
+          label: 'BlueMatter',
           position: 'left',
-          label: 'Docs',
         },
         {
           href: 'https://github.com/Chainscore/bluematter-docs',
@@ -89,7 +125,7 @@ const config: Config = {
     },
     footer: {
       style: 'dark',
-      copyright: `Bluematter - Independent Cardano Node Implementation`,
+      copyright: `BlueMatter - Independent Cardano Node Implementation`,
     },
     prism: {
       theme: prismThemes.github,
diff --git a/knowledge-base/current-state.md b/knowledge-base/current-state.md
@@ -1,3 +1,5 @@
+---
+---
 # Current State
 
 *Last updated: 2026-03-12*
diff --git a/knowledge-base/eras.md b/knowledge-base/eras.md
@@ -1,3 +1,5 @@
+---
+---
 # Eras
 
 > Reference for all Cardano eras, hard forks, protocol versions, and
diff --git a/knowledge-base/intro.md b/knowledge-base/intro.md
@@ -1,5 +1,6 @@
 ---
 sidebar_position: 1
+slug: /intro
 ---
 
 # Bluematter
diff --git a/knowledge-base/ledger-specs.md b/knowledge-base/ledger-specs.md
@@ -1,3 +1,5 @@
+---
+---
 # Ledger Specs
 
 This document is a reference for the Cardano formal ledger specifications, based on the official `.tex` source files in the `cardano-ledger` repository, supplemented with web research on the Conway era. It covers all eras from Shelley through Conway.
diff --git a/knowledge-base/networking.md b/knowledge-base/networking.md
@@ -1,3 +1,5 @@
+---
+---
 # Networking
 
 Reference for the Ouroboros network layer used in Cardano.
diff --git a/knowledge-base/node-architecture.md b/knowledge-base/node-architecture.md
@@ -1,3 +1,5 @@
+---
+---
 # Node Architecture
 
 This document is a technical reference of the Cardano Haskell node
diff --git a/knowledge-base/research.md b/knowledge-base/research.md
@@ -1,3 +1,5 @@
+---
+---
 # Research
 
 Reference covering the academic research that underpins the Cardano
diff --git a/sidebars.ts b/sidebars.ts
diff --git a/sidebarsArch.ts b/sidebarsArch.ts
@@ -0,0 +1,13 @@
+const sidebars = {
+  archSidebar: [
+    'overview',
+    'call-flows',
+    'codec',
+    'crypto',
+    'consensus',
+    'ledger',
+    'network',
+    'node',
+  ],
+};
+export default sidebars;
diff --git a/sidebarsKnowledge.ts b/sidebarsKnowledge.ts
@@ -0,0 +1,12 @@
+const sidebars = {
+  knowledgeSidebar: [
+    'intro',
+    'research',
+    'eras',
+    'node-architecture',
+    'ledger-specs',
+    'networking',
+    'current-state',
+  ],
+};
+export default sidebars;
diff --git a/sidebarsSpec.ts b/sidebarsSpec.ts
@@ -0,0 +1,19 @@
+const sidebars = {
+  specSidebar: [
+    'notation',
+    'crypto',
+    'data-types',
+    'serialization',
+    'ledger-state',
+    'transactions',
+    'scripts',
+    'certificates',
+    'epoch',
+    'rewards',
+    'consensus',
+    'governance',
+    'networking',
+    'storage',
+  ],
+};
+export default sidebars;
diff --git a/specification/certificates.md b/specification/certificates.md
@@ -1,3 +1,5 @@
+---
+---
 # Certificates
 
 This chapter specifies the certificate processing rules for the Conway era.
diff --git a/specification/consensus.md b/specification/consensus.md
@@ -1,3 +1,5 @@
+---
+---
 # Consensus
 
 This section specifies the Ouroboros Praos consensus layer as implemented
diff --git a/specification/crypto.md b/specification/crypto.md
@@ -1,3 +1,5 @@
+---
+---
 # Cryptography
 
 Cardano's Ouroboros Praos consensus relies on four cryptographic
diff --git a/specification/data-types.md b/specification/data-types.md
@@ -1,3 +1,5 @@
+---
+---
 # Data Types
 
 This section defines the core data types of the Bluematter ledger. All types
diff --git a/specification/epoch.md b/specification/epoch.md
@@ -1,3 +1,5 @@
+---
+---
 # Epoch Boundary
 
 This chapter specifies the TICK and NEWEPOCH rules that govern state changes
diff --git a/specification/governance.md b/specification/governance.md
@@ -1,3 +1,5 @@
+---
+---
 # Governance
 
 This section specifies the CIP-1694 on-chain governance framework as
diff --git a/specification/ledger-state.md b/specification/ledger-state.md
@@ -1,3 +1,5 @@
+---
+---
 # Ledger State
 
 This chapter defines the ledger state type, the block and transaction
diff --git a/specification/networking.md b/specification/networking.md
@@ -1,3 +1,5 @@
+---
+---
 # Networking
 
 The Bluematter networking layer implements the Ouroboros family of
diff --git a/specification/notation.md b/specification/notation.md
@@ -1,3 +1,5 @@
+---
+---
 # Notation
 
 This chapter establishes the notation, type conventions, and inference rule
diff --git a/specification/rewards.md b/specification/rewards.md
@@ -1,3 +1,5 @@
+---
+---
 # Rewards
 
 This chapter specifies the Ouroboros Praos reward distribution mechanism,
diff --git a/specification/scripts.md b/specification/scripts.md
@@ -1,3 +1,5 @@
+---
+---
 # Scripts
 
 This chapter specifies the Plutus smart contract execution model as implemented
diff --git a/specification/serialization.md b/specification/serialization.md
@@ -1,3 +1,5 @@
+---
+---
 # Serialization
 
 Cardano has no canonical CBOR encoding. The same logical value may be encoded
diff --git a/specification/storage.md b/specification/storage.md
@@ -1,3 +1,5 @@
+---
+---
 # Storage
 
 The Bluematter storage layer manages block persistence, ledger state
diff --git a/specification/transactions.md b/specification/transactions.md
@@ -1,3 +1,5 @@
+---
+---
 # Transactions
 
 This chapter defines the two phases of transaction validation: Phase-1
diff --git a/src/pages/index.tsx b/src/pages/index.tsx

Original file line number	Diff line number	Diff line change
`@@ -1,3 +1,5 @@`
	`1`	`+---`
	`2`	`+---`
`1`	`3`	`# Call Flows`
`2`	`4`
`3`	`5`	`Every function call in the main sync path, traced from CLI entry to disk write.`