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

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,
@@ -63,24 +74,23 @@ export default defineConfig({
                 { label: "Governance & DAO", slug: "explanations/goal-leaders/governance-dao" },
               ],
             },
-            {
-              label: "System",
-              collapsed: true,
-              items: [
-                { label: "Control Space", slug: "explanations/system/control-space" },
-                { label: "Permission System", slug: "explanations/system/permission-system" },
-                { label: "Emission Permissions", slug: "explanations/system/emission-permissions" },
-                { label: "Capability Permissions", slug: "explanations/system/capability-permissions" },
-                { label: "Recursive Delegation", slug: "explanations/system/recursive-delegation" },
-              ],
-            },
             { label: "Concepts & Terminology", slug: "explanations/concepts-terminology" },
           ],
         },
         {
           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,
@@ -112,16 +122,6 @@ export default defineConfig({
                 { label: "Create Emission Proposal", slug: "how-to-guides/goal-leaders/create-emission-proposal" },
               ],
             },
-            {
-              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" },
-              ],
-            },
           ],
         },
         {

src/content/docs/explanations/table-of-contents.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
 
 
@@ -52,18 +64,6 @@ Understanding governance and leadership systems:
 
 ---
 
-## 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
-- [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
-- [Recursive Delegation](https://docs.torus.network/explanations/system/recursive-delegation/) — Specific capability delegation mechanisms
-
----
-
 
 ## Questions Not Covered Here?
 

src/content/docs/how-to-guides/table-of-contents.mdx

@@ -19,48 +19,48 @@ Whether you're here to use Torus, build on it, or coordinate its evolution, ther
 
 
 
+## System Management
+
+If you're managing permissions and system-level coordination:
+
+- [Create Permission](https://docs.torus.network/how-to-guides/system/create-permission/) — General permission creation and delegation workflow
+- [Create Capability Permission](https://docs.torus.network/how-to-guides/system/create-capability-permission/) — Delegate access to specific agent endpoints and services
+- [Create Emission Permission](https://docs.torus.network/how-to-guides/system/create-emission-permission/) — Share token emission streams with other agents
+- [Manage Permissions](https://docs.torus.network/how-to-guides/system/manage-permissions/) — View, edit, and revoke existing permission delegations
+
+---
+
 ## For Torus Holders
 
 If you want to interact with Torus as an end-user or holder:
 
-- [Set up a Wallet](https://docs.torus.network/how-to-guides/holders/setup-a-wallet/)
-- [Bridge from Base](https://docs.torus.network/how-to-guides/holders/bridge-from-base/)
-- [Stake your TORUS](https://docs.torus.network/how-to-guides/holders/stake-your-torus/)
-- [Vote on Proposals](https://docs.torus.network/how-to-guides/holders/vote-on-proposals/)
+- [Set up a Wallet](https://docs.torus.network/how-to-guides/holders/setup-a-wallet/) — Configure SubWallet to connect to Torus network
+- [Bridge from Base](https://docs.torus.network/how-to-guides/holders/bridge-from-base/) — Transfer TORUS tokens from Base network to Torus
+- [Stake your TORUS](https://docs.torus.network/how-to-guides/holders/stake-your-torus/) — Delegate tokens to agents and participate in network rewards
+- [Vote on Proposals](https://docs.torus.network/how-to-guides/holders/vote-on-proposals/) — Participate in governance decisions and proposal voting
 
 ---
 
 ## For Builders (Agents)
 
 If you're developing tools, services, or integrations on Torus:
 
-- [Register an Agent](https://docs.torus.network/how-to-guides/builders/register-an-agent/)
-- [Manage your Agent](https://docs.torus.network/how-to-guides/builders/manage-your-agent/)
-- [Manage Capabilities](https://docs.torus.network/how-to-guides/builders/manage-capabilities/)
-- [Create a Signal](https://docs.torus.network/how-to-guides/builders/create-signal/)
-- [Setup Agent Server](https://docs.torus.network/how-to-guides/builders/setup-agent-server/)
-- [Setup Agent Client](https://docs.torus.network/how-to-guides/builders/setup-agent-client/)
+- [Register an Agent](https://docs.torus.network/how-to-guides/builders/register-an-agent/) — Submit agent information and burn TORUS for network registration
+- [Manage your Agent](https://docs.torus.network/how-to-guides/builders/manage-your-agent/) — Update agent details, social links, and deregister your agent
+- [Manage Capabilities](https://docs.torus.network/how-to-guides/builders/manage-capabilities/) — Create, edit, and organize your agent's service offerings
+- [Create a Signal](https://docs.torus.network/how-to-guides/builders/create-signal/) — Request specific capabilities from other agents in the network
+- [Setup Agent Server](https://docs.torus.network/how-to-guides/builders/setup-agent-server/) — Build APIs that provide authenticated access to your capabilities
+- [Setup Agent Client](https://docs.torus.network/how-to-guides/builders/setup-agent-client/) — Connect to and consume other agents' services and endpoints
 
 ---
 
 ## For Root Goal-Setters and Leaders  
 
 If you're pioneering new goals or submitting DAO proposals:
 
-- [Become a Root Agent](https://docs.torus.network/how-to-guides/goal-leaders/become-a-root-agent/)
-- [Request DAO Treasury Transfer](https://docs.torus.network/how-to-guides/goal-leaders/request-dao-treasury-transfer/)
-- [Create Emission Proposal](https://docs.torus.network/how-to-guides/goal-leaders/create-emission-proposal/)
-
----
-
-## System Management
-
-If you're managing permissions and system-level coordination:
-
-- [Create Permission](https://docs.torus.network/how-to-guides/system/create-permission/)
-- [Create Capability Permission](https://docs.torus.network/how-to-guides/system/create-capability-permission/)
-- [Create Emission Permission](https://docs.torus.network/how-to-guides/system/create-emission-permission/)
-- [Manage Permissions](https://docs.torus.network/how-to-guides/system/manage-permissions/)
+- [Become a Root Agent](https://docs.torus.network/how-to-guides/goal-leaders/become-a-root-agent/) — Apply for DAO approval to receive direct emission access
+- [Request DAO Treasury Transfer](https://docs.torus.network/how-to-guides/goal-leaders/request-dao-treasury-transfer/) — Request community funding from treasury
+- [Create Emission Proposal](https://docs.torus.network/how-to-guides/goal-leaders/create-emission-proposal/) — Propose changes to network token emission parameters
 
 ---