Reorganize documentation with System section first and improve navigation structure (#36)

* Refactor table of contents to group system-related guides under a new "System" section for better organization and clarity

* Remove redundant notes from the table of contents to streamline guidance on proposal and permission creation processes

* Update index.mdx

* Refactor explanations and guides by updating capability and control space documentation for clarity and improved navigation

* Enhance system documentation by adding and reorganizing sections on permissions and capabilities in explanations and guides

---------

Co-authored-by: rad2520 <[email protected]>

Author: Sipher

astro.config.mjs

@@ -33,6 +33,17 @@ export default defineConfig({
           label: "Explanations",
           items: [
             { label: "Table of Contents", slug: "explanations/table-of-contents" },
+            {
+              label: "System",
+              collapsed: true,
+              items: [
+                { label: "Control Space", slug: "explanations/system/control-space" },
+                { label: "Permission System", slug: "explanations/system/permission-system" },
+                { label: "Recursive Delegation", slug: "explanations/system/recursive-delegation" },
+                { label: "Emission Permissions", slug: "explanations/system/emission-permissions" },
+                { label: "Capability Permissions", slug: "explanations/system/capability-permissions" },
+              ],
+            },
             {
               label: "Holders",
               collapsed: true,
@@ -51,8 +62,6 @@ export default defineConfig({
                 { label: "Demand Signaling", slug: "explanations/builders/demand-signaling" },
                 { label: "Agent Server", slug: "explanations/builders/agent-server" },
                 { label: "Agent Client", slug: "explanations/builders/agent-client" },
-                { label: "Control Space", slug: "explanations/builders/control-space" },
-                { label: "Capability Permissions", slug: "explanations/builders/capability-permissions" },
               ],
             },
             {
@@ -62,9 +71,6 @@ export default defineConfig({
                 { label: "Root Agents", slug: "explanations/goal-leaders/root-agents" },
                 { label: "DAO Treasury", slug: "explanations/goal-leaders/dao-treasury" },
                 { label: "Emission Proposals", slug: "explanations/goal-leaders/emission-proposals" },
-                { label: "Permission System", slug: "explanations/goal-leaders/permissions" },
-                { label: "Recursive Delegation", slug: "explanations/goal-leaders/recursive-delegation" },
-                { label: "Emission Permissions", slug: "explanations/goal-leaders/emission-permissions" },
                 { label: "Governance & DAO", slug: "explanations/goal-leaders/governance-dao" },
               ],
             },
@@ -75,6 +81,16 @@ export default defineConfig({
           label: "How-to Guides",
           items: [
             { label: "Table of Contents", slug: "how-to-guides/table-of-contents" },
+            {
+              label: "System",
+              collapsed: true,
+              items: [
+                { label: "Create Permission", slug: "how-to-guides/system/create-permission" },
+                { label: "Create Capability Permission", slug: "how-to-guides/system/create-capability-permission" },
+                { label: "Create Emission Permission", slug: "how-to-guides/system/create-emission-permission" },
+                { label: "Manage Permissions", slug: "how-to-guides/system/manage-permissions" },
+              ],
+            },
             {
               label: "Holders",
               collapsed: true,
@@ -104,9 +120,6 @@ export default defineConfig({
                 { label: "Become a Root Agent", slug: "how-to-guides/goal-leaders/become-a-root-agent" },
                 { label: "Request DAO Treasury Transfer", slug: "how-to-guides/goal-leaders/request-dao-treasury-transfer" },
                 { label: "Create Emission Proposal", slug: "how-to-guides/goal-leaders/create-emission-proposal" },
-                { label: "Create Capability Permission", slug: "how-to-guides/goal-leaders/create-capability-permission" },
-                { label: "Create Emission Permission", slug: "how-to-guides/goal-leaders/create-emission-permission" },
-                { label: "Manage Permissions", slug: "how-to-guides/goal-leaders/manage-permissions" },
               ],
             },
           ],

src/content/docs/explanations/builders/agent-registration.mdx

@@ -45,7 +45,7 @@ Agent metadata is stored off-chain via IPFS but referenced on-chain through cont
 ### Related Concepts
 
 - **[Root Agents](https://docs.torus.network/explanations/goal-leaders/root-agents/)** - Agents that receive emissions directly
-- **[Permission System](https://docs.torus.network/explanations/goal-leaders/permissions/)** - How agents interact and delegate authority
+- **[Permission System](https://docs.torus.network/explanations/system/permission-system/)** - How agents interact and delegate authority
 - **[Governance & DAO](https://docs.torus.network/explanations/goal-leaders/governance-dao/)** - Understanding DAO decision-making processes
 
 <Aside type="tip" title="Ready to Register?">

src/content/docs/explanations/goal-leaders/emission-proposals.mdx

@@ -51,7 +51,7 @@ For a proposal to pass, it must meet two requirements:
 
 - **[Governance & DAO](https://docs.torus.network/explanations/goal-leaders/governance-dao/)** - Understanding the broader DAO framework
 - **[Tokenomics](https://docs.torus.network/explanations/holders/tokenomics/)** - How TORUS token economics work
-- **[Permission System](https://docs.torus.network/explanations/goal-leaders/permissions/)** - How governance permissions enable proposal creation
+- **[Permission System](https://docs.torus.network/explanations/system/permission-system/)** - How governance permissions enable proposal creation
 
 <Aside type="tip" title="Ready to Create a Proposal?">
   Follow our [emission proposal guide](https://docs.torus.network/how-to-guides/goal-leaders/create-emission-proposal/) to learn the step-by-step process.

…ions/builders/capability-permissions.mdx …ations/system/capability-permissions.mdxsrc/content/docs/explanations/builders/capability-permissions.mdx renamed to src/content/docs/explanations/system/capability-permissions.mdx src/content/docs/explanations/builders/capability-permissions.mdx renamed to src/content/docs/explanations/system/capability-permissions.mdx

@@ -47,11 +47,10 @@ The root owner of a capability path can delegate any amount of permission instan
 
 ### Related Concepts
 
-- **[Permission System](https://docs.torus.network/explanations/goal-leaders/permissions/)** - Core permission mechanics and delegation basics
-- **[Permission System](https://docs.torus.network/explanations/goal-leaders/permissions/)** - Permission system architecture and delegation basics
+- **[Permission System](https://docs.torus.network/explanations/system/permission-system/)** - Core permission mechanics and delegation basics
 - **[Agent Registration](https://docs.torus.network/explanations/builders/agent-registration/)** - How agents become capable of receiving delegations  
 - **[Root Agents](https://docs.torus.network/explanations/goal-leaders/root-agents/)** - Agents with direct emission access for delegation
 
 <Aside type="tip" title="Ready to Create Recursive Delegation?">
-Follow our [step-by-step guide to create capability permissions](https://docs.torus.network/how-to-guides/goal-leaders/create-capability-permission/) for practical implementation instructions.
+Follow our [step-by-step guide to create capability permissions](https://docs.torus.network/how-to-guides/system/create-capability-permission/) for practical implementation instructions.
 </Aside>

…/explanations/builders/control-space.mdx …cs/explanations/system/control-space.mdxsrc/content/docs/explanations/builders/control-space.mdx renamed to src/content/docs/explanations/system/control-space.mdx src/content/docs/explanations/builders/control-space.mdx renamed to src/content/docs/explanations/system/control-space.mdx

@@ -18,6 +18,18 @@ If you need to accomplish a specific task, check out our [How-to Guides](https:/
 These explanations provide deep understanding of how Torus works, the concepts, mechanisms of Torus.   
 
 
+## System Architecture
+
+Core system components and mechanisms:
+
+- [Control Space](https://docs.torus.network/explanations/system/control-space/) — Foundational permission and capability framework
+- [Permission System](https://docs.torus.network/explanations/system/permission-system/) — How agents interact and delegate authority
+- [Recursive Delegation](https://docs.torus.network/explanations/system/recursive-delegation/) — Specific capability delegation mechanisms
+- [Emission Permissions](https://docs.torus.network/explanations/system/emission-permissions/) — How emissions are allocated and controlled
+- [Capability Permissions](https://docs.torus.network/explanations/system/capability-permissions/) — Fine-grained access control for agent endpoints
+
+---
+
 ## For Holders
 
 
@@ -38,8 +50,6 @@ Understanding how agent systems work within Torus:
 - [Demand Signaling](https://docs.torus.network/explanations/builders/demand-signaling/) — Capability coordination and economic incentives
 - [Agent Server](https://docs.torus.network/explanations/builders/agent-server/) — API architecture, authentication, and capability sharing
 - [Agent Client](https://docs.torus.network/explanations/builders/agent-client/) — Communication patterns and authentication flow
-- [Control Space](https://docs.torus.network/explanations/builders/control-space/) — Foundational permission and capability framework
-- [Capability Permissions](https://docs.torus.network/explanations/builders/capability-permissions/) — Fine-grained access control for agent endpoints
 
 ---
 
@@ -50,9 +60,6 @@ Understanding governance and leadership systems:
 - [Root Agents](https://docs.torus.network/explanations/goal-leaders/root-agents/) — DAO approval process and direct emission access
 - [DAO Treasury](https://docs.torus.network/explanations/goal-leaders/dao-treasury/) — Community funding mechanisms and proposal processes
 - [Emission Proposals](https://docs.torus.network/explanations/goal-leaders/emission-proposals/) — How to adjust network economics through governance
-- [Permission System](https://docs.torus.network/explanations/goal-leaders/permissions/) — How agents interact and delegate authority
-- [Recursive Delegation](https://docs.torus.network/explanations/goal-leaders/recursive-delegation/) — Specific capability delegation mechanisms
-- [Emission Permissions](https://docs.torus.network/explanations/goal-leaders/emission-permissions/) — How emissions are allocated and controlled
 - [Governance & DAO](https://docs.torus.network/explanations/goal-leaders/governance-dao/) — Decision-making processes and community coordination
 
 ---

…ns/goal-leaders/emission-permissions.mdx …anations/system/emission-permissions.mdxsrc/content/docs/explanations/goal-leaders/emission-permissions.mdx renamed to src/content/docs/explanations/system/emission-permissions.mdx src/content/docs/explanations/goal-leaders/emission-permissions.mdx renamed to src/content/docs/explanations/system/emission-permissions.mdx

@@ -161,7 +161,7 @@ By removing outdated or unused capabilities, you reduce the attack surface and k
 
 Now that you can manage capabilities, you might want to:
 
-- **Set up delegation**: [Manage permissions](https://docs.torus.network/how-to-guides/goal-leaders/manage-permissions/) to allow other agents to use your capabilities
+- **Set up delegation**: [Manage permissions](https://docs.torus.network/how-to-guides/system/manage-permissions/) to allow other agents to use your capabilities
 - **Build agent services**: Create an [agent server](https://docs.torus.network/how-to-guides/builders/setup-agent-server/) to provide APIs that utilize your registered capabilities
 - **Create demand signals**: Signal for [specific capabilities](https://docs.torus.network/how-to-guides/builders/create-signal/) you need from other agents
 
@@ -171,5 +171,5 @@ Connect with the community:
 - [Twitter](https://x.com/torus_network) — Updates and ecosystem news
 
 <Aside type="tip" title="Want to Learn More?">
-Learn about [recursive delegation](https://docs.torus.network/explanations/goal-leaders/recursive-delegation/) delegation mechanisms and control space architecture.
+Learn about [recursive delegation](https://docs.torus.network/explanations/system/recursive-delegation/) delegation mechanisms and control space architecture.
 </Aside>