Update new folder organization (#17)

* refine how-to guides: enhance clarity on agent management, signal creation, and bridging processes for improved user experience

* revise agent documentation: streamline sections on agent editing, registration, and root agents for enhanced user understanding and experience

* add agent client/server guides: implement step-by-step tutorials for setting up agent client and server with clear instructions and examples

* update how-to guides: replace generic terms with "Torus" for improved specificity and cohesion across documentation

* refactor agent documentation: replace generic terms with specific "Torus" references for clarity and consistency across guides

* enhance explanations section: add detailed topics for better understanding of agent systems and related concepts in Torus documentation

* remove navigation links: clean up outdated prev/next links from agent registration, demand signaling, and root agents documentation

* update agent documentation: restructure sections for builders and leaders, enhancing hierarchy and clarity in Torus guides

Author: Sipher

astro.config.mjs

@@ -33,17 +33,62 @@ export default defineConfig({
             },
           ],
         },
+        {
+          label: "Explanations",
+          items: [
+            { label: "Start Here", slug: "explanations/start-here" },
+            {
+              label: "Builders",
+              collapsed: false,
+              items: [
+                { label: "Agent Registration", slug: "explanations/builders/agent-registration" },
+                { label: "Agent Server", slug: "explanations/builders/agent-server" },
+                { label: "Agent Client", slug: "explanations/builders/agent-client" },
+                { label: "Agent Editing", slug: "explanations/builders/agent-editing" },
+                { label: "Demand Signaling", slug: "explanations/builders/demand-signaling" },
+              ],
+            },
+            {
+              label: "Leaders",
+              collapsed: false,
+              items: [
+                { label: "Root Agents", slug: "explanations/root-agents/root-agents" },
+              ],
+            },
+          ],
+        },
         {
           label: "How-to Guides",
           items: [
             { label: "Start Here", slug: "how-to-guides/start-here" },
-            { label: "Setup a Wallet", slug: "how-to-guides/setup-a-wallet" },
-            { label: "Bridge to Base", slug: "how-to-guides/bridge-to-base"},
-            { label: "Stake your Torus", slug: "how-to-guides/stake-your-torus" },
-            { label: "Register an Agent", slug: "how-to-guides/register-an-agent" },
-            { label: "Become a Root Agent", slug: "how-to-guides/become-a-root-agent" },
-            { label: "Edit your Agent", slug: "how-to-guides/edit-your-agent" },
-            { label: "Setup CLI", slug: "how-to-guides/setup-cli" },
+            {
+              label: "Participants",
+              collapsed: false,
+              items: [
+                { label: "Setup a Wallet", slug: "how-to-guides/participants/setup-a-wallet" },
+                { label: "Bridge from Base", slug: "how-to-guides/participants/bridge-from-base" },
+                { label: "Stake your Torus", slug: "how-to-guides/participants/stake-your-torus" },
+              ],
+            },
+            {
+              label: "Builders",
+              collapsed: false,
+              items: [
+                { label: "Setup CLI", slug: "how-to-guides/builders/setup-cli" },
+                { label: "Register an Agent", slug: "how-to-guides/builders/register-an-agent" },
+                { label: "Edit your Agent", slug: "how-to-guides/builders/edit-your-agent" },
+                { label: "Create a Signal", slug: "how-to-guides/builders/create-signal" },
+                { label: "Setup Agent Server", slug: "how-to-guides/builders/setup-agent-server" },
+                { label: "Setup Agent Client", slug: "how-to-guides/builders/setup-agent-client" },
+              ],
+            },
+            {
+              label: "Leaders",
+              collapsed: false,
+              items: [
+                { label: "Become a Root Agent", slug: "how-to-guides/root-agents/become-a-root-agent" },
+              ],
+            },
           ],
         },
         {
@@ -60,33 +105,22 @@ export default defineConfig({
             { label: "Governance & DAO", slug: "concepts/governance-dao" },
           ],
         },
-        {
-          label: "Working with Agents",
-          items: [
-            { label: "Register an Agent", slug: "agents/register-agent" },
-            { label: "Become a Root Agent", slug: "agents/apply-root-agent" },
-            { label: "Agent Server", slug: "agents/server-setup" },
-            { label: "Agent Client", slug: "agents/client" },
-            { label: "Demand Signaling", slug: "agents/demand-signaling" },
-            { label: "Managing Your Agent", slug: "agents/management" },
-          ],
-        },
         {
           label: "CLI & Tools",
           items: [
             { label: "Key Management", slug: "cli/key-management" },
             { label: "Balance Operations", slug: "cli/balance-operations" },
           ],
         },
-        {
-          label: "Web Apps",
-          items: [
-            { label: "Torus Portal", slug: "web-apps/torus-portal" },
-            { label: "Torus Allocator", slug: "web-apps/torus-allocator" },
-            { label: "Torus Wallet", slug: "web-apps/torus-wallet" },
-            { label: "Torus DAO", slug: "web-apps/torus-dao" },
-          ],
-        },
+        // {
+        //   label: "Web Apps",
+        //   items: [
+        //     { label: "Torus Portal", slug: "web-apps/torus-portal" },
+        //     { label: "Torus Allocator", slug: "web-apps/torus-allocator" },
+        //     { label: "Torus Wallet", slug: "web-apps/torus-wallet" },
+        //     { label: "Torus DAO", slug: "web-apps/torus-dao" },
+        //   ],
+        // },
         {
           label: "Development",
           items: [