feat: enhance documentation with collapsible sections and a new "Staking" guide for improved user experience and information access

Author: Sipher

astro.config.mjs

@@ -37,6 +37,7 @@ export default defineConfig({
             { label: "Table of Contents", slug: "explanations/table-of-contents" },
             {
               label: "v0.5",
+              collapsed: true,
               items: [
                 { label: "Control Space", slug: "explanations/v05/control-space" },
                 { label: "Permission System", slug: "explanations/v05/permissions" },
@@ -48,9 +49,16 @@ export default defineConfig({
                 { label: "Governance & DAO", slug: "explanations/v05/governance-dao" },
               ],
             },
+            {
+              label: "Holders",
+              collapsed: true,
+              items: [
+                { label: "Staking", slug: "explanations/holders/staking" },
+              ],
+            },
             {
               label: "Builders",
-              collapsed: false,
+              collapsed: true,
               items: [
                 { label: "Agent Registration", slug: "explanations/builders/agent-registration" },
                 { label: "Agent Editing", slug: "explanations/builders/agent-editing" },
@@ -61,7 +69,7 @@ export default defineConfig({
             },
             {
               label: "Goal Leaders",
-              collapsed: false,
+              collapsed: true,
               items: [
                 { label: "Root Agents", slug: "explanations/goal-leaders/root-agents" },
                 { label: "Emission Proposals", slug: "explanations/goal-leaders/emission-proposals" },
@@ -75,7 +83,7 @@ export default defineConfig({
             { label: "Table of Contents", slug: "how-to-guides/table-of-contents" },
             {
               label: "Holders",
-              collapsed: false,
+              collapsed: true,
               items: [
                 { label: "Setup a Wallet", slug: "how-to-guides/holders/setup-a-wallet" },
                 { label: "Bridge from Base", slug: "how-to-guides/holders/bridge-from-base" },
@@ -84,7 +92,7 @@ export default defineConfig({
             },
             {
               label: "Builders",
-              collapsed: false,
+              collapsed: true,
               items: [
                 { label: "Register an Agent", slug: "how-to-guides/builders/register-an-agent" },
                 { label: "Edit your Agent", slug: "how-to-guides/builders/edit-your-agent" },
@@ -98,7 +106,7 @@ export default defineConfig({
             },
             {
               label: "Goal Leaders",
-              collapsed: false,
+              collapsed: true,
               items: [
                 { label: "Become a Root Agent", slug: "how-to-guides/goal-leaders/become-a-root-agent" },
                 { label: "Create Emission Proposal", slug: "how-to-guides/goal-leaders/create-emission-proposal" },
@@ -112,7 +120,7 @@ export default defineConfig({
             { label: "Table of Contents", slug: "development/table-of-contents" },
             {
               label: "Web Apps",
-              collapsed: false,
+              collapsed: true,
               items: [
                 {
                   label: "Overview and Setup",
@@ -126,7 +134,7 @@ export default defineConfig({
             },
             {
               label: "CLI Reference",
-              collapsed: false,
+              collapsed: true,
               items: [
                 { label: "Setup CLI", slug: "development/cli/setup-cli" },
                 { label: "Key Management", slug: "development/cli/key-management" },
@@ -135,7 +143,7 @@ export default defineConfig({
             },
             {
               label: "Network Operations",
-              collapsed: false,
+              collapsed: true,
               items: [
                 { label: "Global Parameters", slug: "development/network/global-parameters" },
                 { label: "Running a Node", slug: "development/network/running-node" },

src/content/docs/explanations/holders/staking.mdx

@@ -0,0 +1,39 @@
+---
+title: Staking
+description: Understanding the staking mechanism, incentives, and how token holders participate in Torus network security and governance.
+---
+
+import {
+  Aside,
+  Card,
+  CardGrid,
+  Code,
+  Steps,
+  Tabs,
+  TabItem,
+} from "@astrojs/starlight/components";
+
+
+Stake is the organism's root container of authority and monetary energy, transmutable towards its emergent agency.
+Forming a circular value flow between incentives and stake in their outcome. Stake is permissionless, while everything else is permissioned by stake.
+
+Staking is the core mechanism through which TORUS holders secure the network, participate in governance,
+and earn rewards while supporting the agents and initiatives they believe in.
+
+
+### Core Mechanics
+
+- When you stake, your TORUS are **locked** in the Root Allocator
+- Tokens remain **owned by the staker** but cannot be used for transaction purposes
+- It accounts for network consensus, such as, voting, allocating and commenting on proposals
+- Staking rewards are generated from network emissions
+
+## Related Concepts
+
+- **[Tokenomics](https://docs.torus.network/getting-started/tokenomics/)** - Understanding TORUS token economics and emission structure
+- **[Emission Proposals](https://docs.torus.network/explanations/goal-leaders/emission-proposals/)** - How staking parameters can be adjusted through governance
+- **[Agent Registration](https://docs.torus.network/explanations/builders/agent-registration/)** - Understanding the agents you can support through staking
+
+<Aside type="tip" title="Ready to Start Staking?">
+  Follow our [staking guide](https://docs.torus.network/how-to-guides/holders/stake-your-torus/) to learn the step-by-step process for staking your TORUS tokens.
+</Aside>

src/content/docs/explanations/table-of-contents.mdx

@@ -15,7 +15,7 @@ Welcome to the **Explanations** section of the Torus documentation.
 
 If you need to accomplish a specific task, check out our [How-to Guides](https://docs.torus.network/how-to-guides/start-here/) instead.   
 
-These explanations provide deep understanding of how Torus works — the concepts, mechanisms of Torus.   
+These explanations provide deep understanding of how Torus works, the concepts, mechanisms of Torus.   
 
 ## v0.5 Related Topics
 
@@ -29,6 +29,14 @@ Understanding the technical implementation and design of Torus v0.5:
 
 ---
 
+## For Holders
+
+Understanding how holders participate in the network:
+
+- [Staking](https://docs.torus.network/explanations/holders/staking/) — Staking mechanisms, incentives, and reward distribution
+
+---
+
 ## For Builders (Agents)
 
 Understanding how agent systems work within Torus:

src/content/docs/how-to-guides/builders/create-permission.mdx

@@ -262,7 +262,10 @@ After creating permissions, you can:
 For help with permission management:
 
 - [Torus Community Discord](https://discord.gg/torus)
-- [Permission System Documentation](https://docs.torus.network/explanations/v05/permissions/)
+
+<Aside type="tip" title="Want to Learn More?">
+See the [Permission System Documentation](https://docs.torus.network/explanations/v05/permissions/) for technical details.
+</Aside>
 
 #### Related Topics
 

src/content/docs/how-to-guides/builders/create-signal.mdx

@@ -109,4 +109,8 @@ Now that you've created a signal, you might want to:
  Connect with the community:
 - [Discord](https://discord.gg/torus) — Technical discussions, support, and announcements
 - [Telegram](https://t.me/torusnetwork) — General chat and announcements
-- [Twitter](https://x.com/torus_network) — Updates and ecosystem news
+- [Twitter](https://x.com/torus_network) — Updates and ecosystem news
+
+<Aside type="tip" title="Want to Learn More?">
+Learn about [demand signaling](https://docs.torus.network/explanations/builders/demand-signaling/) capability coordination and economic incentives.
+</Aside>

src/content/docs/how-to-guides/builders/delegate-emission-streams.mdx

@@ -343,7 +343,10 @@ With emission delegations configured, you can:
 For help with emission delegations:
 
 - [Torus Community Discord](https://discord.gg/torus)
-- [Emission Permissions Documentation](https://docs.torus.network/explanations/v05/emission-permissions/)
+
+<Aside type="tip" title="Want to Learn More?">
+See the [Emission Permissions Documentation](https://docs.torus.network/explanations/v05/emission-permissions/) for technical details.
+</Aside>
 
 #### Related Topics
 

src/content/docs/how-to-guides/builders/edit-your-agent.mdx

@@ -103,4 +103,8 @@ After updating your agent information:
  Connect with the community:
 - [Discord](https://discord.gg/torus) — Technical discussions, support, and announcements
 - [Telegram](https://t.me/torusnetwork) — General chat and announcements
-- [Twitter](https://x.com/torus_network) — Updates and ecosystem news  
+- [Twitter](https://x.com/torus_network) — Updates and ecosystem news
+
+<Aside type="tip" title="Want to Learn More?">
+Learn about [agent editing](https://docs.torus.network/explanations/builders/agent-editing/) update mechanics and storage architecture.
+</Aside>

src/content/docs/how-to-guides/builders/manage-capabilities.mdx

@@ -156,11 +156,15 @@ 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**: Delegate permissions to allow other agents to use your capabilities *(coming soon)*
+- **Set up delegation**: [Manage permissions](https://docs.torus.network/how-to-guides/builders/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
 
 Connect with the community:
 - [Discord](https://discord.gg/torus) — Technical discussions, support, and announcements
 - [Telegram](https://t.me/torusnetwork) — General chat and announcements
-- [Twitter](https://x.com/torus_network) — Updates and ecosystem news
+- [Twitter](https://x.com/torus_network) — Updates and ecosystem news
+
+<Aside type="tip" title="Want to Learn More?">
+Learn about [capability permissions](https://docs.torus.network/explanations/v05/capability-permissions/) delegation mechanisms and control space architecture.
+</Aside>