Add staking info and capability how-to (#26)

* Add "Manage Permissions" link in the start-here guide to improve user navigation for managing capabilities in Torus

* refactor: update "Start Here" to "Table of Contents" across documentation for improved organization and clarity

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

* fix: reformat links in documentation for token holders, agent builders, and swarm leaders for better readability and access

* refactor: remove deprecated "Delegate Emission Streams" guide and tidy up table of contents for better documentation structure

Author: Sipher

astro.config.mjs

@@ -34,9 +34,10 @@ export default defineConfig({
         {
           label: "Explanations",
           items: [
-            { label: "Start Here", slug: "explanations/start-here" },
+            { 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" },
@@ -72,10 +80,10 @@ export default defineConfig({
         {
           label: "How-to Guides",
           items: [
-            { label: "Start Here", slug: "how-to-guides/start-here" },
+            { 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,21 +92,20 @@ 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" },
                 { label: "Manage Capabilities", slug: "how-to-guides/builders/manage-capabilities" },
+                { label: "Manage Permissions", slug: "how-to-guides/builders/manage-permissions" },
                 { label: "Create a Signal", slug: "how-to-guides/builders/create-signal" },
-                // { label: "Manage Permissions", slug: "how-to-guides/builders/manage-permissions" },
-                // { label: "Delegate Emission Streams", slug: "how-to-guides/builders/delegate-emission-streams" },
                 { 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: "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" },
@@ -109,10 +116,10 @@ export default defineConfig({
         {
           label: "Development",
           items: [
-            { label: "Start Here", slug: "development/start-here" },
+            { label: "Table of Contents", slug: "development/table-of-contents" },
             {
               label: "Web Apps",
-              collapsed: false,
+              collapsed: true,
               items: [
                 {
                   label: "Overview and Setup",
@@ -126,7 +133,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 +142,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" },

…/content/docs/development/start-here.mdx …t/docs/development/table-of-contents.mdxsrc/content/docs/development/start-here.mdx renamed to src/content/docs/development/table-of-contents.mdx src/content/docs/development/start-here.mdx renamed to src/content/docs/development/table-of-contents.mdx

@@ -1,5 +1,5 @@
 ---
-title: Start Here
+title: Table of Contents
 description: Technical documentation and tools for developing with and on Torus.
 ---
 import {

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>

…content/docs/explanations/start-here.mdx …/docs/explanations/table-of-contents.mdxsrc/content/docs/explanations/start-here.mdx renamed to src/content/docs/explanations/table-of-contents.mdx src/content/docs/explanations/start-here.mdx renamed to src/content/docs/explanations/table-of-contents.mdx

@@ -1,5 +1,5 @@
 ---
-title: Start Here
+title: Table of Contents
 description: Deep-dive explanations to help you understand how Torus works under the hood.
 ---
 import {
@@ -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,15 +29,23 @@ 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:
 
 - [Agent Registration](https://docs.torus.network/explanations/builders/agent-registration/) — Registration economics, burn mechanisms, and discovery
-- [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
 - [Agent Editing](https://docs.torus.network/explanations/builders/agent-editing/) — Update mechanics and storage architecture
 - [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
 
 ---
 

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>