diff --git a/astro.config.mjs b/astro.config.mjs
index c172733..ab52287 100644
--- a/astro.config.mjs
+++ b/astro.config.mjs
@@ -26,12 +26,24 @@ export default defineConfig({
           label: "Getting Started",
           items: [
             { label: "Introduction", slug: "index" },
+            { label: "Tokenomics", slug: "concepts/tokenomics" },
             {
               label: "Concepts & Terminology",
               slug: "getting-started/concepts",
             },
-            { label: "Setup CLI", slug: "getting-started/setup-cli" },
-            { label: "Setup Wallet", slug: "getting-started/setup-wallet" },
+          ],
+        },
+        {
+          label: "How-to Guides",
+          items: [
+            { label: "Start Here", slug: "how-to-guides/start-here" },
+            { label: "Setup a Wallet", slug: "how-to-guides/setup-a-wallet" },
+            { label: "Bridge to Base", slug: "how-to-guides/bridge-to-base"},
+            { label: "Stake your Torus", slug: "how-to-guides/stake-your-torus" },
+            { label: "Register an Agent", slug: "how-to-guides/register-an-agent" },
+            { label: "Become a Root Agent", slug: "how-to-guides/become-a-root-agent" },
+            { label: "Edit your Agent", slug: "how-to-guides/edit-your-agent" },
+            { label: "Setup CLI", slug: "how-to-guides/setup-cli" },
           ],
         },
         {
@@ -45,7 +57,6 @@ export default defineConfig({
               slug: "v05/capability-permissions",
             },
             { label: "Emission Permissions", slug: "v05/emission-permissions" },
-            { label: "Tokenomics", slug: "concepts/tokenomics" },
             { label: "Governance & DAO", slug: "concepts/governance-dao" },
           ],
         },
@@ -99,20 +110,6 @@ export default defineConfig({
             },
           ],
         },
-        {
-          label: "How-to Guides",
-          items: [
-            { label: "Setup a Wallet", slug: "how-to-guides/setup-a-wallet" },
-            { label: "Bridge to Base", slug: "how-to-guides/bridge-to-base"},
-            { label: "Stake your Torus", slug: "how-to-guides/stake-your-torus" },
-            { label: "Register an Agent", slug: "how-to-guides/register-an-agent" },
-            { label: "Become a Root Agent", slug: "how-to-guides/become-a-root-agent" },
-            // {
-            //   label: "Setup a wallet",
-            //   slug: "how-to-guides/setup-a-wallet",
-            // },
-          ],
-        },
       ],
       customCss: ["./src/tailwind.css"],
     }),
diff --git a/public/images/how-to-guide/edit-your-agent/allocator-card-edit-agent.png b/public/images/how-to-guide/edit-your-agent/allocator-card-edit-agent.png
new file mode 100644
index 0000000..5e7def3
Binary files /dev/null and b/public/images/how-to-guide/edit-your-agent/allocator-card-edit-agent.png differ
diff --git a/public/images/how-to-guide/edit-your-agent/allocator-success-toast.png b/public/images/how-to-guide/edit-your-agent/allocator-success-toast.png
new file mode 100644
index 0000000..6f4356e
Binary files /dev/null and b/public/images/how-to-guide/edit-your-agent/allocator-success-toast.png differ
diff --git a/public/images/how-to-guide/register-an-agent/registered-agent-on-allocator-page.png b/public/images/how-to-guide/register-an-agent/registered-agent-on-allocator-page.png
new file mode 100644
index 0000000..06c0e4d
Binary files /dev/null and b/public/images/how-to-guide/register-an-agent/registered-agent-on-allocator-page.png differ
diff --git a/src/content/docs/agents/server-setup.mdx b/src/content/docs/agents/server-setup.mdx
index a1445ea..71a2b34 100644
--- a/src/content/docs/agents/server-setup.mdx
+++ b/src/content/docs/agents/server-setup.mdx
@@ -23,7 +23,7 @@ The AgentServer uses **Hono** for HTTP routing and **Zod** for input validation,
 - **Namespace Permissions**: Blockchain-based access control
 - **OpenAPI Documentation**: Automatic API documentation generation
 - **Type Safety**: Full TypeScript support with Zod schemas
-- **Blockchain Integration**: Direct connection to Torus Network
+- **Blockchain Integration**: Direct connection to Torus
 
 ## Installation
 
@@ -180,7 +180,7 @@ const agent = new AgentServer({
 
 ## Namespace Permissions
 
-The AgentServer integrates with Torus Network's capability permission system for fine-grained access control.
+The AgentServer integrates with Torus capability permission system for fine-grained access control.
 
 ### Basic Namespace Protection
 
diff --git a/src/content/docs/how-to-guides/become-a-root-agent.mdx b/src/content/docs/how-to-guides/become-a-root-agent.mdx
index c0ff31a..60400b1 100644
--- a/src/content/docs/how-to-guides/become-a-root-agent.mdx
+++ b/src/content/docs/how-to-guides/become-a-root-agent.mdx
@@ -14,14 +14,14 @@ import daoShapeTheNetwork from '/public/images/how-to-guide/become-a-root-agent/
 import selectTheWhitelistOption from '/public/images/how-to-guide/become-a-root-agent/select-the-whitelist-option.png';
 
 
-In this guide, we’ll walk through how to **apply to become a Root Agent** on the Torus Network.  
+In this guide, we'll walk through how to **apply to become a Root Agent** on Torus.  
 This is a step-by-step overview of the application process.
 
 Becoming a Root Agent allows you to receive emissions directly from the root and play a central role in the network's permission and delegation structure.  
 
 <Aside>
 - Applying does **not guarantee approval** — all applications are subject to DAO review.  
-- You don’t need to be a Root Agent to actively participate in the Torus Network.  
+- You don't need to be a Root Agent to actively participate in Torus.  
 - Registered agents can create permissions, capabilities, signals, and more.  
   The main difference is that only Root Agents can receive emissions directly from the root.  
 - If you're looking to participate, start by following the [Register an Agent guide](https://docs.torus.network/how-to-guides/register-an-agent/).
@@ -44,7 +44,7 @@ Becoming a Root Agent allows you to receive emissions directly from the root and
   </Card>
   <Card title="Torus Balance" icon="seti:shell">
     Check your balance on the [Torus Wallet](https://wallet.torus.network) and ensure you have enough Free Balance to cover the registration fees.
-    You can find a [guide on how to bridge Torus here](https://docs.torus.network/how-to-guides/bridge-to-base/).
+    You can find a [guide on how to bridge TORUS here](https://docs.torus.network/how-to-guides/bridge-to-base/).
   </Card>
   <Card title="Discord Account" icon="discord">
     Have a valid Discord account and join the official [Torus Discord
@@ -63,14 +63,14 @@ Becoming a Root Agent allows you to receive emissions directly from the root and
 2. **Connect your Torus Wallet**  
    Click the **Connect Wallet** button at the top right and select your Torus wallet.  
 
-3. **Click in Shape the Network Button**  
-    It can be found in the top right corner of the dashboard.  
+3. **Click on Shape the Network Button**  
+    It is located in the top right corner of the dashboard.  
     It will open a modal with a form to apply for whitelisting.
     <ClickableImage src={daoShapeTheNetwork} alt="Shape the network button" />
 
 4. **Select the Whitelist an Agent option and fill the form**    
-    In modal, select the option **Whitelist an Agent** and fill in the required fields for your application.    
-    In this step you must validate your **Discord Account** in order to apply.
+    In the modal, select the option **Whitelist an Agent** and fill in the required fields for your application.    
+    In this step, you must validate your **Discord Account** in order to apply.
     <Aside>
         Your Discord account is used solely to validate your application via OAuth.  
         We do **not** collect or store your password, and we **never** have access to your Discord credentials.
@@ -82,9 +82,9 @@ Becoming a Root Agent allows you to receive emissions directly from the root and
     <ClickableImage src={selectTheWhitelistOption} alt="Select whitelist option" />
 
 5. **Submit Proposal**  
-    Click in **Submit Proposal** and confirm the transaction in your wallet after you filled in the form.
+    After filling in the form, click **Submit Proposal** and confirm the transaction in your wallet.
     <Aside>
-        The proposal cost (**100 Torus**) will be deducted from your connected wallet.
+        The proposal cost (**100 TORUS**) will be deducted from your connected wallet.
 
         - If your application is **accepted**, the fee will be refunded.  
         - If your application is **rejected**, the fee will be **burned permanently** and cannot be recovered.
@@ -92,14 +92,14 @@ Becoming a Root Agent allows you to receive emissions directly from the root and
 
       
 6. **All Done**   
-   You’ve now successfully Applited to Whitelist an Agent on Torus.  
+   You've now successfully Applied to Whitelist an Agent on Torus.  
    Now you must wait for DAO members to review your application.  
    You can follow the process through the [Whitelist DAO Page](https://dao.torus.network/whitelist-applications)
 </Steps>
 
 
 ## Support and Resources
-   If you want to understand more about the core differences between a Registered agent and a Whitelisted agent, you can relate to the [Concepts & Terminology](https://docs.torus.network/getting-started/concepts/) section.  
+   If you want to understand more about the core differences between a Registered agent and a Whitelisted agent, you can refer to the [Concepts & Terminology](https://docs.torus.network/getting-started/concepts/) section.  
    You can also get help directly from the community via:
 
    - [Torus Community Discord](https://discord.gg/torus)  
diff --git a/src/content/docs/how-to-guides/bridge-to-base.mdx b/src/content/docs/how-to-guides/bridge-to-base.mdx
index 3c25797..6f95806 100644
--- a/src/content/docs/how-to-guides/bridge-to-base.mdx
+++ b/src/content/docs/how-to-guides/bridge-to-base.mdx
@@ -1,6 +1,6 @@
 ---
 title: Bridge Torus from Base to Torus
-description: Bridging from Torus Base all the way to Native Torus on the Torus Network.
+description: Bridging from Torus Base all the way to Native TORUS on the Network.
 ---
 
 import {
@@ -19,10 +19,10 @@ import fillInFormToConvertTorusEvmNativeTorus from '/public/images/how-to-guide/
 import confirmTransactionInMetamaskTorusEvmToTorus from '/public/images/how-to-guide/bridge-to-base/confirm-transaction-in-metamask-torus-evm-to-torus.png';
 import torusEvmConvertSuccessfully from '/public/images/how-to-guide/bridge-to-base/torus-evm-convert-successfully.png';
 
-In this guide, we’ll **bridge Torus between the Torus Network and Base**.  
-This process is necessary in order to obtain **Native Torus**, which is required to interact with the Torus Network directly.
+In this guide, we'll **bridge TORUS between Torus and Base**.  
+This process is necessary in order to obtain **Native TORUS**, which is required to interact with Torus directly.
 
-**Native Torus** is used for essential on-chain actions, such as:
+**Native TORUS** is used for essential on-chain actions, such as:
 
 - Registering an Agent
 - Becoming a Root Agent  
@@ -30,12 +30,14 @@ This process is necessary in order to obtain **Native Torus**, which is required
 - Creating a signal  
 - And more...
 
-For the sake of simplicity, we are going to refer to the **Native Torus** as **Torus**.
+To keep things clear and concise, **Native TORUS** will be referred to as **TORUS** from this point forward.
+
+
 
 #### What we will accomplish
 
-- Bridge Torus on Base to Torus EVM
-- Bridge from Torus EVM to Torus
+- Bridge TORUS on Base to TORUS EVM
+- Bridge from TORUS EVM to TORUS
 
 <Aside>
 ⏱️ **Estimated time to complete this guide: 20 minutes**
@@ -51,17 +53,17 @@ For the sake of simplicity, we are going to refer to the **Native Torus** as **T
     If you don't have one, you can follow the [setup guide here](https://docs.torus.network/how-to-guides/setup-a-wallet/).
   </Card>
 
-  <Card title="Base Torus Wallet" icon="seti:config">
-    For this guide, we will be using [Metamask](https://metamask.io/) as our wallet of choice.  
+  <Card title="Base TORUS Wallet" icon="seti:config">
+    For this guide, we will be using [MetaMask](https://metamask.io/) as our wallet of choice.  
     You must have enough funds to cover the bridge fees.  
-    {/* If you don't have Base Torus or funds to cover the fees, you can follow the steps in this video tutorial by Omni Labs. */}
+    {/* If you don't have Base TORUS or funds to cover the fees, you can follow the steps in this video tutorial by Omni Labs. */}
   </Card>
 </CardGrid>
 
 ---
 
 <Aside type="danger">
-  Avoid using SubWallet to have BASE Torus on it, as it will cause issues with the bridge that could result in loss of funds.
+  Avoid storing BASE TORUS in SubWallet, as it will cause issues with the bridge that could result in loss of funds.
 </Aside> 
 
 ## Steps for the Bridge Process
@@ -70,14 +72,14 @@ For the sake of simplicity, we are going to refer to the **Native Torus** as **T
 
 <Steps>
 
-1. **Connect both the Torus and Metamask wallets in the [Base Bridge Web App](https://bridge.torus.network/?tab=base&from=base&to=torus)**.   
+1. **Connect both the Torus and MetaMask wallets in the [Base Bridge Web App](https://bridge.torus.network/?tab=base&from=base&to=torus)**.   
    At the top right corner of the app, connect both your **Torus Wallet** and **MetaMask**.
-   <ClickableImage src={metamaskSubwalletConnect} alt="SubWallet and Metamask connect screen" />
+   <ClickableImage src={metamaskSubwalletConnect} alt="SubWallet and MetaMask connect screen" />
 
-2. **Swap from Base Torus to Torus EVM**  
-    - Make sure you are **connected** in **Both Wallets**
-    - Make sure you are in the **correct Tab**, **TORUS EVM - Base**
-    - Make sure it is **FROM** Base Torus **TO** Torus EVM
+2. **Swap from Base TORUS to Torus EVM**  
+    - Make sure you are **connected** to **both wallets**
+    - Make sure you are on the **correct tab**, **TORUS EVM - Base**
+    - Make sure it is **FROM** Base TORUS **TO** Torus EVM
    
    Fill in the form with the amount you want to convert and the Recipient Address, by clicking on the Self button, it will automatically fill the address for you with your connected base wallet.
    With all the information filled in, click **Continue**.
@@ -87,15 +89,15 @@ For the sake of simplicity, we are going to refer to the **Native Torus** as **T
 3. **Confirm the transaction**   
    After filling in the form, you will be prompted to confirm the transaction in Metamask.
    <Aside type="caution">
-      Always verify the transaction in Metamask before signing it, it is of your responsibility to verify the transaction details.  
-      You also must have enough funds in your Metamask wallet to cover the transaction fees.
+      Always verify the transaction in MetaMask before signing it, as it is your responsibility to verify the transaction details.  
+      You also must have enough funds in your MetaMask wallet to cover the transaction fees.
    </Aside>
-   <ClickableImage src={confirmTransactionInMetamask} alt="Confirm the transaction in Metamask" />
+   <ClickableImage src={confirmTransactionInMetamask} alt="Confirm the transaction in MetaMask" />
 
 4. **Confirmation of the swap**  
-   After the transaction succeeds, your Base Torus should now be displayed as Torus EVM as it was successfully swapped.  
-   This process can take a while to happen in the chain side,
-   so please, wait a few minutes and refresh the [Base Bridge Web App](https://bridge.torus.network/?tab=base&from=base&to=torus).   
+   After the transaction succeeds, your Base TORUS should now be displayed as Torus EVM as it was successfully swapped.  
+   This process can take a while to complete on the blockchain,
+   so please wait a few minutes and refresh the [Base Bridge Web App](https://bridge.torus.network/?tab=base&from=base&to=torus).   
    If you have any issues, reach out to our support on the [Official Torus Discord](https://discord.gg/torus).  
    <ClickableImage src={baseTorusSwappedSuccessfully} alt="Confirmation of the swap" />
 
@@ -107,9 +109,9 @@ For the sake of simplicity, we are going to refer to the **Native Torus** as **T
 ### Bridge Torus EVM to Torus
 
 <Steps>
-1. **Connect both the Torus and Metamask wallets in the [Base Bridge Web App](https://bridge.torus.network/?tab=base&from=base&to=torus)**.   
+1. **Connect both the Torus and MetaMask wallets in the [Base Bridge Web App](https://bridge.torus.network/?tab=base&from=base&to=torus)**.   
    At the top right corner of the app, connect both your **Torus Wallet** and **MetaMask**.
-   <ClickableImage src={metamaskConnectEvm} alt="SubWallet and Metamask connect screen" />
+   <ClickableImage src={metamaskConnectEvm} alt="SubWallet and MetaMask connect screen" />
 
 
 1. **Swap from Torus EVM to Torus**
@@ -118,32 +120,32 @@ For the sake of simplicity, we are going to refer to the **Native Torus** as **T
    - Make sure it is **FROM** Torus EVM **TO** Torus
 
    Fill in the form with the amount you want to convert, after confirmation, you will be prompted to sign the transaction in Torus.
-   <ClickableImage src={fillInFormToConvertTorusEvmNativeTorus} alt="Convert Torus EVM to Native Torus" />
+   <ClickableImage src={fillInFormToConvertTorusEvmNativeTorus} alt="Convert Torus EVM to Native TORUS" />
 
 2. **Confirm the transaction**  
    After filling in the form, you will be prompted to confirm the transaction in Metamask.
    <Aside type="caution">
-      Always verify the transaction in Metamask before signing it, it is of your responsibility to verify the transaction details.  
-      You also must have enough funds in your Metamask wallet to cover the transaction fees.
+      Always verify the transaction in MetaMask before signing it, as it is your responsibility to verify the transaction details.  
+      You also must have enough funds in your MetaMask wallet to cover the transaction fees.
    </Aside>
    
-   <ClickableImage src={confirmTransactionInMetamaskTorusEvmToTorus} alt="Confirm the transaction in Metamask" />
+   <ClickableImage src={confirmTransactionInMetamaskTorusEvmToTorus} alt="Confirm the transaction in MetaMask" />
 
 3. **Confirmation of the swap**  
-   After the transaction succeeds, your Torus EVM should now be displayed as Torus as it was successfully swapped.
-   This process can take a while to happen in the chain side,
-   so please, wait a few minutes and refresh the [Base Bridge Web App](https://bridge.torus.network/?tab=base&from=base&to=torus).   
+   After the transaction succeeds, your Torus EVM should now be displayed as TORUS as it was successfully swapped.
+   This process can take a while to complete on the blockchain,
+   so please wait a few minutes and refresh the [Base Bridge Web App](https://bridge.torus.network/?tab=base&from=base&to=torus).   
    <ClickableImage src={torusEvmConvertSuccessfully} alt="Confirmation of the swap" />
 
 4. **All Done**   
-   You’ve now successfully bridged Torus tokens between **Torus**, **Torus EVM**, and **Base**.  
+   You've now successfully bridged TORUS tokens between **Torus**, **Torus EVM**, and **Base**.  
    You can view your updated balances directly in the [Torus Web App](https://wallet.torus.network) or SubWallet.
 </Steps>
 
 
 ## Support and Resources
    By following these steps, you can successfully bridge your tokens between Torus, Torus EVM, and Base.
-   Holding native Torus is required to interact with the Torus Network, and currently, this is the only supported method for bridging.  
+   Holding native TORUS is required to interact with Torus, and currently, this is the only supported method for bridging.  
    If you need help or have questions, you can reach out through the official community channels:
 
    - [Torus Community Telegram](https://t.me/torusnetwork)
diff --git a/src/content/docs/how-to-guides/edit-your-agent.mdx b/src/content/docs/how-to-guides/edit-your-agent.mdx
new file mode 100644
index 0000000..7759732
--- /dev/null
+++ b/src/content/docs/how-to-guides/edit-your-agent.mdx
@@ -0,0 +1,94 @@
+---
+title: Edit your Agent information
+description: Update your agent's details, social links, and technical information.
+---
+
+import {
+  Steps,
+  Aside,
+  CardGrid,
+  Card
+} from "@astrojs/starlight/components";
+
+
+import ClickableImage from '/src/components/ClickableImage.astro';
+import registeredAgents from '/public/images/how-to-guide/register-an-agent/registered-agent-on-allocator-page.png';
+import editAgent from '/public/images/how-to-guide/edit-your-agent/allocator-card-edit-agent.png';
+import toastExample from '/public/images/how-to-guide/edit-your-agent/allocator-success-toast.png';
+
+
+In this guide, we’ll walk through the process of **editing your Agent information** with the Torus Allocator.
+Both the **Registered Agent** and **Root Agent** can edit their information. Just make sure to use the proper filter on the Allocator Page.  
+In this guide we will be editing the information of a **Registered Agent**.
+
+#### What we will accomplish
+
+- Edit your Agent's description and technical details
+- Update your Agent's social links and contact information
+- Modify your Agent's website URL, API endpoint, and icon
+
+<Aside>
+⏱️ **Estimated time to complete this guide: 5 minutes**
+</Aside>
+
+## Prerequisites
+
+<CardGrid>
+  <Card title="Torus Wallet" icon="seti:license">
+    Make sure you have a Torus wallet set up and ready to use.
+    You can find a [guide on how to set up a wallet here](https://docs.torus.network/how-to-guides/setup-a-wallet/).
+  </Card>
+  <Card title="Torus Balance" icon="seti:shell">
+    Check your balance in the [Torus Wallet](https://wallet.torus.network) and ensure you have enough Free Balance to cover the registration fees.
+    You can find a [guide on how to bridge TORUS here](https://docs.torus.network/how-to-guides/bridge-to-base/).
+  </Card>
+  <Card title="Registered or Root Agent" icon="seti:license">
+    You must have a Registered or Root Agent to edit your information.
+  </Card>
+  </CardGrid>
+
+
+  ## Edit your Agent Information
+
+<Steps>
+1. **Find your Agent in the [Allocator App](https://allocator.torus.network/)**   
+    You can either search for your Agent by name or by the address.  
+
+   <ClickableImage src={registeredAgents} alt="Allocator Page" />
+
+2. **Click on the card of your Agent**    
+    The edit is in the Detailed View of the Agent.
+   <ClickableImage src={editAgent} alt="Edit Agent" />
+
+3. **Edit the information and Submit**  
+    You can edit the following information:
+    ```md
+    # Short Description 
+    # Description
+    # Technical Information
+        - Website URL
+        - API Endpoint URL
+        - Agent Icon
+    # Social Links
+        - Discord
+        - Twitter
+        - GitHub
+        - Telegram
+    ```
+4. **Sign the Transaction in the SubWallet and Wait for the Confirmation**   
+  You will be prompted by SubWallet to sign the on-chain transaction.
+  Once confirmed, a toast notification will appear to indicate that your allocation was successful.
+    <ClickableImage src={toastExample} alt="Allocator Success Toast" />
+
+5. **All Done**  
+  You can now see your updated information in the Allocator App.
+
+  
+</Steps>
+
+## Support and Resources
+   If you want to understand more about what is a Registered Agent or Root Agent, you can refer to the [Concepts & Terminology](https://docs.torus.network/getting-started/concepts/) section.  
+   You can also get help from the community through:
+
+   - [Torus Community Discord](https://discord.gg/torus)  
+   - [Torus Telegram Group](https://t.me/torusnetwork)  
\ No newline at end of file
diff --git a/src/content/docs/how-to-guides/register-an-agent.mdx b/src/content/docs/how-to-guides/register-an-agent.mdx
index 3d388cc..16a3016 100644
--- a/src/content/docs/how-to-guides/register-an-agent.mdx
+++ b/src/content/docs/how-to-guides/register-an-agent.mdx
@@ -15,8 +15,9 @@ import registerAnAgentButton from '/public/images/how-to-guide/register-an-agent
 import connectWalletOnPortal from '/public/images/how-to-guide/register-an-agent/connect-wallet-on-portal.png';
 import filledAgentInformation from '/public/images/how-to-guide/register-an-agent/filled-agent-information.png';
 import filledAgentSocials from '/public/images/how-to-guide/register-an-agent/filled-agent-socials.png';
+import registeredAgents from '/public/images/how-to-guide/register-an-agent/registered-agent-on-allocator-page.png';
 
-In this guide, we’ll **register an Agent** on the Torus Network.  
+In this guide, we'll **register an Agent** on Torus.  
 This is a step-by-step walkthrough of the registration process.
 
 Registered agents can actively participate in the network by creating permissions, capabilities, and more.
@@ -48,8 +49,8 @@ Registered agents can actively participate in the network by creating permission
     You can find a [guide on how to set up a wallet here](https://docs.torus.network/how-to-guides/setup-a-wallet/).
   </Card>
   <Card title="Torus Balance" icon="seti:shell">
-    Check your balance on the [Torus Wallet](https://wallet.torus.network) and ensure you have enough Free Balance to cover the registration fees.
-    You can find a [guide on how to bridge Torus here](https://docs.torus.network/how-to-guides/bridge-to-base/).
+    Check your balance in the [Torus Wallet](https://wallet.torus.network) and ensure you have enough Free Balance to cover the registration fees.
+    You can find a [guide on how to bridge TORUS here](https://docs.torus.network/how-to-guides/bridge-to-base/).
   </Card>
 </CardGrid>
 
@@ -69,7 +70,7 @@ Registered agents can actively participate in the network by creating permission
    Provide the required information such as your agent name, description, and technical details.  
    <Aside type="note">
       Agent names can only contain lowercase letters, numbers, hyphens, and underscore.
-       - agent-name-     (Invalid agent Name). Reason: Hifen in the end
+       - agent-name-     (Invalid agent Name). Reason: Hyphen at the end
        - **A**gent-name  (Invalid agent Name). Reason: Uppercase letter
        - Agent name      (Invalid agent Name). Reason: Space in the middle
        - Agent.name      (Invalid agent Name). Reason: Dot as separator
@@ -85,27 +86,32 @@ Registered agents can actively participate in the network by creating permission
    <ClickableImage src={filledAgentSocials} alt="Agent metadata input" />
 
 5. **Confirm registration**  
-   Click in register an agent and confirm the transaction in your wallet.
+   Click on register an agent and confirm the transaction in your wallet.
    <Aside>
-      When you hover the mouse on the Registration Fee Price, you will see the breakthrough price of the registration fees.    
+      When you hover the mouse on the Registration Fee Price, you will see the breakdown of the registration fees.    
 
       These fees are divided between:
-      - Network Fee: Fixed 15 Torus Fee. Burned permanently
-      - Capability Creation Fee: Fixed 3.29 Torus Fee. Burned permanently
+      - Transaction Fee: Variable network fee. Burned permanently
+      - Agent Registration Fee: Fixed 15 TORUS Fee. Burned permanently
+      - Capability Creation Fee: Fixed 3.29 TORUS Fee. Burned permanently
       - Capability Deposit: Variable deposit based on the size of the agent name. This value is refunded when the capability is removed.
    </Aside>
       
-4. **All Done**   
-   You’ve now successfully Registered an Agent on Torus.
-   You can now participate in the network by creating permissions, capabilities and much more.
+6. **Check your Agent on the [Allocator Page](https://allocator.torus.network/?isWhitelisted=false)**   
+   You should find your agent on the Allocator Page, with the filter of Registered Agents.
+   <ClickableImage src={registeredAgents} alt="Allocator Page" />
+
+6. **All Done**   
+   You've now successfully registered an Agent on Torus.
+   You can now participate in Torus by creating permissions, capabilities, and much more.
 
 
 </Steps>
 
 
 ## Support and Resources
-   If you want to understand more about what is a Registered Agent, you can relate to the [Concepts & Terminology](https://docs.torus.network/getting-started/concepts/) section.  
-   You can also get help directly from the community via:
+   If you want to understand more about what is a Registered Agent, you can refer to the [Concepts & Terminology](https://docs.torus.network/getting-started/concepts/) section.  
+   You can also get help from the community through:
 
    - [Torus Community Discord](https://discord.gg/torus)  
    - [Torus Telegram Group](https://t.me/torusnetwork)  
\ No newline at end of file
diff --git a/src/content/docs/how-to-guides/setup-a-wallet.mdx b/src/content/docs/how-to-guides/setup-a-wallet.mdx
index f0a96b6..4b4537a 100644
--- a/src/content/docs/how-to-guides/setup-a-wallet.mdx
+++ b/src/content/docs/how-to-guides/setup-a-wallet.mdx
@@ -63,7 +63,7 @@ For simplicity’s sake, though, we’ll focus on SubWallet.
 
  <Steps>
 
-1.  **Open the SubWallet extension in you browser**:   
+1.  **Open the SubWallet extension in your browser**:   
      Click on the SubWallet icon in your browser’s extension area to open the wallet.
 
 2.  **Click Create a New Account**:  
@@ -73,7 +73,7 @@ For simplicity’s sake, though, we’ll focus on SubWallet.
     - Import account
     - Connect existing account   
         
-    Select **Create new account** option.
+    Select the **"Create new account"** option.
 
 
 3.  **Create a Master Password**:  
@@ -91,11 +91,11 @@ For simplicity’s sake, though, we’ll focus on SubWallet.
     </Aside>
 
 5.  **Create an account name**:   
-    Choose an account name, this does not impact on anything, so feel free to choose any name you like. If you want to change it later, you can do so from the account settings.
+    Choose an account name, this does not impact anything, so feel free to choose any name you like. If you want to change it later, you can do so from the account settings.
 
         <span style={{ fontSize: "0.9rem", fontStyle: "italic" }}>
 
-        Below is a reference image of a successfull account created in the
+        Below is a reference image of a successfully created account in the
         SubWallet extension:
 
         </span>
@@ -109,7 +109,7 @@ For simplicity’s sake, though, we’ll focus on SubWallet.
 <Steps>
 
   1. **Open the Subwallet Setup**  
-    Click in the three bars(**☰**) on the top left corner of the subwallet extension.    
+    Click on the three bars (**☰**) on the top left corner of the subwallet extension.    
      <ClickableImage src={subwalletOpenSetup} alt="SubWallet setup button" />
 
   2. **Select Manage Networks**   
@@ -155,7 +155,7 @@ By following these steps, you can effectively set up and start using your SubWal
 
 ## Other Supported Wallets
 
-While this guide uses SubWallet, other wallets are also compatible with the Torus Network.
+While this guide uses SubWallet, other wallets are also compatible with Torus.
 The list below includes some of the most known and tested options, but it may not cover every possible wallet.
 
 These wallets are not officially endorsed, and while they are known to work with Substrate networks, we recommend using them only if you're already familiar or willing to explore.
diff --git a/src/content/docs/how-to-guides/setup-cli.mdx b/src/content/docs/how-to-guides/setup-cli.mdx
new file mode 100644
index 0000000..77ffc16
--- /dev/null
+++ b/src/content/docs/how-to-guides/setup-cli.mdx
@@ -0,0 +1,152 @@
+---
+title: Setup Torus CLI
+description: Install and configure the Torus CLI for managing your keys, tokens, and agents.
+---
+
+import {
+  Steps,
+  Aside,
+  CardGrid,
+  Card,
+  Tabs,
+  TabItem
+} from "@astrojs/starlight/components";
+
+In this guide, we'll walk through **installing and setting up the Torus CLI** on your system.  
+The CLI provides command-line access to manage keys, tokens, agents, and network operations.
+
+#### What we will accomplish
+
+- Install the Torus CLI on your system
+- Verify the installation works correctly
+- Set up shell completions for better usability
+
+<Aside>
+⏱️ **Estimated time to complete this guide: 5 minutes**
+</Aside>
+
+## Prerequisites
+
+<CardGrid>
+  <Card title="System Requirements" icon="seti:config">
+    Choose your installation method based on your system setup:
+    - **Python users**: [Python 3.10+](https://www.python.org/) and [pip](https://pip.pypa.io/en/stable/installation/)
+    - **Nix users**: [Nix package manager](https://github.com/NixOS/nix)
+  </Card>
+</CardGrid>
+
+## Install Torus CLI
+<Steps>
+
+  1. **Choose your installation method**  
+    Select the method that matches your system setup.   
+
+     <Tabs>
+       <TabItem label="Using PIP (Recommended)">
+
+        Install the Torus CLI using pip:
+
+        ```sh
+        pip install torusdk
+        ```
+
+        **For Poetry users**, add to your project:
+
+        ```sh
+        poetry add torusdk
+        ```
+      </TabItem>
+      <TabItem label="Using Nix">
+        Clone and install using Nix:
+
+        ```sh
+        git clone https://github.com/renlabs-dev/torus-cli
+        cd torus-cli
+        nix profile install .
+        ```
+       </TabItem>
+     </Tabs>
+
+
+2. **Verify the installation**  
+   Check that the CLI is installed correctly:
+
+   ```sh
+   torus --version
+   ```
+
+   You should see the version number displayed.
+
+3. **Test basic functionality**  
+   Run a simple command to ensure everything works:
+
+   ```sh
+   torus network params
+   ```
+
+   This will display the current network parameters, confirming your CLI can connect to Torus.
+
+4. **Set up shell completions (optional)**  
+   Enable tab completion for better usability:
+
+   ```sh
+   # For bash users
+   torus --install-completion bash
+
+   # For zsh users  
+   torus --install-completion zsh
+   ```
+
+   <Aside type="tip">
+   Restart your terminal or run `source ~/.bashrc` (or `source ~/.zshrc`) to activate completions.
+   </Aside>
+
+5. **All Done**  
+   Your Torus CLI is now ready to use! You can manage keys, check balances, and interact with agents.
+
+</Steps>
+
+{/* 
+
+## Basic CLI Usage
+
+Now that you have the CLI installed, here are the main command categories:
+
+**Key Management:**
+```sh
+torus key create my-key          # Create a new key
+torus key list                   # List all keys
+torus key balances              # Show key balances
+```
+
+**Balance Operations:**
+```sh
+torus balance show <address>     # Check balance
+torus balance transfer <key> <amount> <recipient>  # Send tokens
+```
+
+**Network Information:**
+```sh
+torus network params            # Network parameters
+torus misc circulating-supply   # Total supply info
+```
+
+## Support and Resources
+
+For detailed command reference and advanced usage, see the CLI documentation sections.  
+If you encounter installation issues, you can get help from:
+
+- [Torus CLI GitHub Issues](https://github.com/renlabs-dev/torus-cli/issues/new/choose)
+- [Torus Community Discord](https://discord.gg/torus)
+- [Torus CLI Discord Channel](https://discord.com/channels/1306654856286699590/1306654857046003716)
+
+#### Related Topics
+
+<CardGrid>
+  <Card title="Key Management" icon="seti:key">
+    <a href="/cli/key-management">Learn to create and manage your keys</a>
+  </Card>
+  <Card title="Balance Operations" icon="seti:shell">
+    <a href="/cli/balance-operations">Transfer tokens and manage staking</a>
+  </Card>
+</CardGrid> */}
\ No newline at end of file
diff --git a/src/content/docs/how-to-guides/stake-your-torus.mdx b/src/content/docs/how-to-guides/stake-your-torus.mdx
index 16fd1de..e44bd84 100644
--- a/src/content/docs/how-to-guides/stake-your-torus.mdx
+++ b/src/content/docs/how-to-guides/stake-your-torus.mdx
@@ -1,5 +1,5 @@
 ---
-title: Stake your Torus with the Torus Allocator
+title: Stake your TORUS with the Torus Allocator
 description: Contributing to the Torus as a User.
 ---
 
@@ -22,7 +22,7 @@ import allocatorConfirmAllocationAndSubmit from '/public/images/how-to-guide/sta
 import allocatorConfirmAndSignTransaction from '/public/images/how-to-guide/stake-your-torus/allocator-confirm-and-sign-transaction.png';
 import allocatorDoneAllocated from '/public/images/how-to-guide/stake-your-torus/allocator-done-allocated.png';
 
-In this guide, we’ll walk through the process of **staking and allocating your Torus** with the Torus Allocator.  
+In this guide, we'll walk through the process of **staking and allocating your TORUS** with the Torus Allocator.  
 Staking allows you to earn rewards while contributing to the security and stability of the network.  
 By allocating to an Agent, you directly support their operations.
 
@@ -33,8 +33,9 @@ By allocating to an Agent, you directly support their operations.
 
 #### What we will accomplish
 
-- Stake your Torus to support an Agent.
-- Earn emission rewards.
+- Stake your TORUS to the Allocator contract
+- Allocate your staked TORUS to specific Agents
+- Earn emission rewards from your allocations
 
 ## Prerequisites
 
@@ -45,17 +46,17 @@ By allocating to an Agent, you directly support their operations.
   </Card>
   <Card title="Torus Balance" icon="seti:shell">
     Check your balance on the [Torus Wallet](https://wallet.torus.network) and ensure you have enough Free Balance to cover the registration fees.
-    You can find a [guide on how to bridge Torus here](https://docs.torus.network/how-to-guides/bridge-to-base/).
+    You can find a [guide on how to bridge TORUS here](https://docs.torus.network/how-to-guides/bridge-to-base/).
   </Card>
 </CardGrid>
 
-## Steps to Stake your Torus
-### Send your Torus to the Allocator Contract
+## Steps to Stake your TORUS
+### Send your TORUS to the Allocator Contract
 
 <Steps>
 
 1. **Go to the [Staking tab in the Torus Wallet App](https://wallet.torus.network/staking)**   
-   In the Torus Wallet App, click on the **Staking** tab. Then click in **Stake**.
+   In the Torus Wallet App, click on the **Staking** tab. Then click on **Stake**.
    <ClickableImage src={walletStakingTab} alt="Staking tab in the Torus Wallet App" />
 
 2. **Connect your Torus Wallet**  
@@ -63,7 +64,7 @@ By allocating to an Agent, you directly support their operations.
    <ClickableImage src={connectToWallet} alt="Connect your Torus Wallet" />
 
 3. **Select the Allocator Address**  
-   Click in the Select an Allocator, it will drop a Modal with all the Allocators.  
+   Click on the Select an Allocator, it will drop a Modal with all the Allocators.  
    Select the **Torus Allocator** option.
    <Aside>
       The torus allocator address is `5DoVVgN7R6vHw4mvPX8s4EkkR8fgN1UJ5TDfKzab8eW9z89b`
@@ -72,26 +73,26 @@ By allocating to an Agent, you directly support their operations.
 4. **Fill in the required fields and confirm**  
     After you:   
     - Selected the **Allocator Address**  
-   - Entered the **amount of Torus** you wanted to stake   
+   - Entered the **amount of TORUS** you wanted to stake   
 
-   Click in **Review & Submit Transaction**.
+   Click on **Review & Submit Transaction**.
 
    <Aside>
    Fees are paid using your **Free Balance**, not your staked amount.  
    All staking fees are **burned permanently** and cannot be recovered.
    </Aside>
 
-   <ClickableImage src={fillInInformation} alt="Stake your Torus" />
+   <ClickableImage src={fillInInformation} alt="Stake your TORUS" />
 
 
 5. **Open SubWallet and Sign the Transaction**    
-    Click in the Subwallet icon at the top right navigation bar of your browser.  
+    Click on the Subwallet icon at the top right navigation bar of your browser.  
     It will open a modal with the confirmation to sign the transaction.
     <ClickableImage src={openSubwalletAndSign} alt="SubWallet sign transaction" />
 
 
-6. **Your Torus is now staked, but you must allocate to an Agent**
-    After signing your Torus should show as **Staked Balance** in the Wallet App.  
+6. **Your TORUS is now staked, but you must allocate to an Agent**
+    After signing your TORUS should show as **Staked Balance** in the Wallet App.  
     This process can take a few minutes to complete, make sure to reload the page to see the updated balance.
     When you see your staked balance, you can now allocate to an Agent.
    <ClickableImage src={stakedBalanceSuccessfully} alt="Staked Balance" />
@@ -113,7 +114,7 @@ By allocating to an Agent, you directly support their operations.
    - **Orange** → A short summary of the agent’s purpose or work  
    - **Blue** → An interactive slider of how much **you** have allocated to this agent
 
-   You can hover the mouse through the components to see the details.  
+   You can hover your mouse over the components to see the details.  
 
    <ClickableImage src={allocatorAppCardExplanation} alt="Torus Allocator App" />
 
@@ -130,13 +131,13 @@ By allocating to an Agent, you directly support their operations.
 
 3. **Open the Allocation Menu and Confirm**    
    When you open the Allocation Menu, you will see the list of the agents you’ve chosen to allocate to.  
-   If you are sure that you want to allocate to these agents, click in **Submit Agents**.
+   If you are sure that you want to allocate to these agents, click on **Submit Agents**.
 
    <ClickableImage src={allocatorConfirmAllocationAndSubmit} alt="Allocator-confirm-allocation-and-submit" />
 
 4. **Sign the Transaction in the SubWallet**    
    After confirming the allocation, you will be prompted to sign the transaction in your wallet.  
-   Click in the SubWallet icon at the top right navigation bar of your browser.   
+   Click on the SubWallet icon at the top right navigation bar of your browser.   
    It will open a modal with the confirmation to sign the transaction.  
    <ClickableImage src={allocatorConfirmAndSignTransaction} alt="SubWallet sign transaction" />
 
@@ -154,7 +155,7 @@ By allocating to an Agent, you directly support their operations.
 
    
 ## Support and Resources
-   If you want to understand more about Weight Power and how it works, you can relate to the [Concepts & Terminology](https://docs.torus.network/getting-started/concepts) section.  
-   You can also get help directly from the community via:
+   If you want to understand more about Weight Power and how it works, you can refer to the [Concepts & Terminology](https://docs.torus.network/getting-started/concepts) section.  
+   You can also get help from the community through:
    - [Torus Community Discord](https://discord.gg/torus)  
    - [Torus Telegram Group](https://t.me/torusnetwork)  
diff --git a/src/content/docs/how-to-guides/start-here.mdx b/src/content/docs/how-to-guides/start-here.mdx
new file mode 100644
index 0000000..cb24d6c
--- /dev/null
+++ b/src/content/docs/how-to-guides/start-here.mdx
@@ -0,0 +1,72 @@
+---
+title: Start Here
+description: Step-by-step walkthroughs to help users and builders interact with Torus.
+---
+import {
+  Steps,
+  Aside,
+  CardGrid,
+  Card,
+  Tabs,
+  TabItem
+} from "@astrojs/starlight/components";
+
+Welcome to the **How-to Guides** section of the Torus documentation.
+
+These guides are focused, practical, and designed to help you achieve specific outcomes within the Torus ecosystem — without distractions or deep dives into theory.   
+If you prefer to start with the theory first, begin with [Control Space](https://dev.docs.torus.network/v05/control-space/) and continue from there.   
+Whether you're here to use the network, build on it, or coordinate its evolution, there's a guide to get you there.
+
+
+
+## For Network Participants
+
+If you want to interact with Torus as an end-user or holder:
+
+- [Set up a Wallet](https://docs.torus.network/how-to-guides/setup-a-wallet/)
+- [Bridge from Base to Torus](https://docs.torus.network/how-to-guides/bridge-to-base/)
+- [Stake your TORUS](https://docs.torus.network/how-to-guides/stake-your-torus/)
+- Allocate Emissions _(coming soon)_
+
+---
+
+## For Builders (Agents)
+
+If you're developing tools, services, or integrations on Torus:
+
+- [Setup CLI](https://docs.torus.network/how-to-guides/setup-cli/)
+- [Register an Agent](https://docs.torus.network/how-to-guides/register-an-agent/)
+- [Edit your Agent](https://docs.torus.network/how-to-guides/edit-your-agent/)
+- Create a Signal _(coming soon)_
+- Capability (Namespace) Registration _(coming soon)_
+- Agent API Wrapping _(coming soon)_ 
+
+---
+
+## For Root Goal-Setters and Leaders  
+_Leading new swarms or driving protocol changes_
+
+If you're pioneering new goals or submitting DAO proposals:
+
+- [Become a Root Agent](https://docs.torus.network/how-to-guides/become-a-root-agent/)
+- _See the [Governance & DAO](https://docs.torus.network/concepts/governance-dao/) section for docs on proposal types and formats._  
+
+---
+
+
+## Additional Resources
+
+Can’t find the guide you’re looking for? Connect with us through our community channels:
+
+- **[Torus Discord](https://discord.gg/torus)** — Ask technical questions, get support, or join our community calls.
+- **[Torus Telegram](https://t.me/torusnetwork)** — Quick help, casual discussion, and important updates.
+- **[Torus Twitter](https://twitter.com/torus_network)** — Stay up to date with announcements and news from the Torus ecosystem.
+
+
+### Core Projects
+
+Torus is fully open source. You’re welcome to explore, contribute, or report issues:
+
+- **[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.