Finish refactoring folder structure (#19)

* 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

* remove setup guides: delete outdated CLI and wallet setup documentation from the Torus getting started section

* update control space link: fix URL to point to the correct documentation page in the start-here section of Torus guides

* Refactor config slugs for improved clarity; add immutable agent name warnings to documentation

* Migrate balance operations and key management documentation to development directory; update links accordingly

* Update web app documentation by restructuring file locations and links; delete outdated files and improve clarity in navigation

Author: Sipher

astro.config.mjs

@@ -26,7 +26,7 @@ export default defineConfig({
           label: "Getting Started",
           items: [
             { label: "Introduction", slug: "index" },
-            { label: "Tokenomics", slug: "concepts/tokenomics" },
+            { label: "Tokenomics", slug: "getting-started/tokenomics" },
             {
               label: "Concepts & Terminology",
               slug: "getting-started/concepts",
@@ -40,14 +40,14 @@ export default defineConfig({
             {
               label: "v0.5",
               items: [
-                { label: "Control Space", slug: "v05/control-space" },
-                { label: "Permission System", slug: "v05/permissions" },
+                { label: "Control Space", slug: "explanations/v05/control-space" },
+                { label: "Permission System", slug: "explanations/v05/permissions" },
                 {
                   label: "Capability Permissions",
-                  slug: "v05/capability-permissions",
+                  slug: "explanations/v05/capability-permissions",
                 },
-                { label: "Emission Permissions", slug: "v05/emission-permissions" },
-                { label: "Governance & DAO", slug: "concepts/governance-dao" },
+                { label: "Emission Permissions", slug: "explanations/v05/emission-permissions" },
+                { label: "Governance & DAO", slug: "explanations/v05/governance-dao" },
               ],
             },
             {
@@ -104,33 +104,48 @@ export default defineConfig({
             },
           ],
         },
-        {
-          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: "Development",
           items: [
+            { label: "Start Here", slug: "development/start-here" },
             {
-              label: "Web Apps Overview and Setup",
-              slug: "development/web-apps-overview-and-setup",
+              label: "Web Apps",
+              collapsed: false,
+              items: [
+                {
+                  label: "Overview and Setup",
+                  slug: "development/web/overview-and-setup",
+                },
+                {
+                  label: "Querying Data",
+                  slug: "development/web/querying-data",
+                },
+              ],
             },
             {
-              label: "Querying Data",
-              slug: "development/querying-data",
+              label: "CLI Reference",
+              collapsed: false,
+              items: [
+                { label: "Key Management", slug: "development/cli/key-management" },
+                { label: "Balance Operations", slug: "development/cli/balance-operations" },
+              ],
             },
-          ],
-        },
-        {
-          label: "Network Operations",
-          items: [
-            { label: "Global Parameters", slug: "network/global-parameters" },
             {
-              label: "Running a Node",
-              slug: "network/running-node",
+              label: "Network Operations",
+              collapsed: false,
+              items: [
+                { label: "Global Parameters", slug: "development/network/global-parameters" },
+                { label: "Running a Node", slug: "development/network/running-node" },
+              ],
             },
           ],
         },

src/content/docs/concepts/agents.mdx

@@ -43,4 +43,4 @@ The unstaking command is defined as follows:
 torus balance unstake <key-name> <amount> <allocator-ss58address>
 ```
 
-You can also specify the name of the key, if it's located on your disk. Same as in transferring or staking.
+You can also specify the name of the key, if it's located on your disk. Same as in transferring or staking.

src/content/docs/concepts/network-overview.mdx

@@ -45,7 +45,7 @@ This command displays both public and private key details, ensuring you have acc
 To list all keys stored on your system, execute:
 
 ```sh
-# Lists the names and addresses of keys stored on disk.
+# Lists the names and addresses of keys stored on disk.
 torus key list
 ```
 
@@ -69,4 +69,4 @@ You can also sort the balance by **all, free, staked** (default all summed balan
 torus key balances --sort-balance free
 ```
 
-Will return the keys sorted by their free balance.
+Will return the keys sorted by their free balance.

…/content/docs/cli/balance-operations.mdx …s/development/cli/balance-operations.mdxsrc/content/docs/cli/balance-operations.mdx renamed to src/content/docs/development/cli/balance-operations.mdx src/content/docs/cli/balance-operations.mdx renamed to src/content/docs/development/cli/balance-operations.mdx

@@ -86,4 +86,4 @@ You can query all of these global parameters using CLI:
 
 ```bash
 torus network params
-```
+```

src/content/docs/cli/key-management.mdx …/docs/development/cli/key-management.mdxsrc/content/docs/cli/key-management.mdx renamed to src/content/docs/development/cli/key-management.mdx src/content/docs/cli/key-management.mdx renamed to src/content/docs/development/cli/key-management.mdx

@@ -85,4 +85,4 @@ cargo xtask run local --alice
 
 ## Additional Information
 
-- You can customize your node's configuration by modifying the appropriate files in the project.
+- You can customize your node's configuration by modifying the appropriate files in the project.

…ntent/docs/network/global-parameters.mdx …evelopment/network/global-parameters.mdxsrc/content/docs/network/global-parameters.mdx renamed to src/content/docs/development/network/global-parameters.mdx src/content/docs/network/global-parameters.mdx renamed to src/content/docs/development/network/global-parameters.mdx

@@ -0,0 +1,60 @@
+---
+title: Start Here
+description: Technical documentation and tools for developing with and on Torus.
+---
+import {
+  Steps,
+  Aside,
+  CardGrid,
+  Card,
+  Tabs,
+  TabItem
+} from "@astrojs/starlight/components";
+
+Welcome to the **Development** section of the Torus documentation.
+
+This section provides comprehensive technical resources for developers building with Torus — from setting up development environments to running nodes and managing keys.   
+Whether you're integrating with existing web apps, querying data, or running your own infrastructure, you'll find the technical details here.
+
+## Web Application Development
+
+Building and integrating with the Torus ecosystem:
+
+- [Overview and Setup](https://docs.torus.network/development/web/overview-and-setup/) — Setting up the development environment and understanding the monorepo structure
+- [Querying Data](https://docs.torus.network/development/web/querying-data/) — API operations for retrieving stake allocation and network data
+
+---
+
+## CLI & Tools
+
+Command-line operations for key and balance management:
+
+- [Key Management](https://docs.torus.network/development/cli/key-management/) — Creating, importing, and managing cryptographic keys
+- [Balance Operations](https://docs.torus.network/development/cli/balance-operations/) — Transferring and staking operations via CLI
+
+---
+
+## Network Infrastructure
+
+Running and configuring Torus network infrastructure:
+
+- [Global Parameters](https://docs.torus.network/development/network/global-parameters/) — Understanding and configuring blockchain parameters
+- [Running a Node](https://docs.torus.network/development/network/running-node/) — Setting up and operating a Torus Substrate node
+
+---
+
+## Questions Not Covered Here?
+
+Need help with development tasks? The community is here to help:
+
+- **[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
+
+### Core Projects
+
+Explore the open source code to understand implementation details:
+
+- **[torus-substrate](https://github.com/renlabs-dev/torus-substrate)** — Core blockchain runtime built on Substrate
+- **[torus-ts](https://github.com/renlabs-dev/torus-ts)** — TypeScript SDK for building on Torus and WebApps
+- **[torus-docs](https://github.com/renlabs-dev/torus-docs)** — This documentation