Restructure docs navigation around user intent

astro.config.js

@@ -39,6 +39,9 @@ export default defineConfig({
 		'/developer/duskds/overview': '/developer/duskvm/overview',
 		'/developer/duskds/quickstart': '/developer/duskvm/quickstart',
 		'/developer/duskds/reference': '/developer/duskvm/reference',
+		'/learn/web-wallet': '/use/wallets#web-wallet',
+		'/learn/rusk-wallet': '/use/wallets#rusk-wallet',
+		'/use/dusk-wallet': '/use/wallets#dusk-wallet',
 	},
 	integrations: [
 		starlight({

public/llms-full.txt

@@ -57,7 +57,7 @@ DuskDS supports:
 Relevant docs:
 
 - https://docs.dusk.network/learn/deep-dive/duskds-tx-models/
-- https://docs.dusk.network/learn/web-wallet/
+- https://docs.dusk.network/use/wallets/
 
 ### Execution Paths
 
@@ -86,28 +86,29 @@ Relevant docs:
 - Core Components: https://docs.dusk.network/learn/core-components/
 - Core Values: https://docs.dusk.network/learn/core-values/
 - Native Issuance: https://docs.dusk.network/learn/tokenization-comparison/
-- Ecosystem & Partners: https://docs.dusk.network/learn/ecosystem/
+- Ecosystem: https://docs.dusk.network/learn/ecosystem/
 - Tokenomics: https://docs.dusk.network/learn/tokenomics/
 - Glossary: https://docs.dusk.network/learn/glossary/
 
-### Developer
+### Build
 
 - Developer Overview: https://docs.dusk.network/developer/overview/
 - DuskEVM Quickstart: https://docs.dusk.network/developer/duskevm/quickstart/
 - DuskVM Overview: https://docs.dusk.network/developer/duskvm/overview/
 - DuskVM Quickstart: https://docs.dusk.network/developer/duskvm/quickstart/
 - DuskVM Contract Reference: https://docs.dusk.network/developer/duskvm/reference/
 - Dusk Connect: https://docs.dusk.network/developer/integrations/dusk-connect/
-- Dusk Wallet Extension: https://docs.dusk.network/developer/integrations/wallet-extension/
+- Dusk Wallet Integration: https://docs.dusk.network/developer/integrations/wallet-extension/
 - Transaction Lifecycle: https://docs.dusk.network/developer/integrations/tx-lifecycle/
 - HTTP API: https://docs.dusk.network/developer/integrations/http-api/
+- Historical Events: https://docs.dusk.network/developer/integrations/historical_events/
 - W3sper SDK: https://docs.dusk.network/developer/integrations/w3sper/
 - Exchange Integration: https://docs.dusk.network/developer/integrations/exchanges/
 - Encoding & Hashing: https://docs.dusk.network/developer/integrations/reference/
 - Dusk Improvement Proposals: https://docs.dusk.network/developer/contribute/dips/
 - Grants: https://docs.dusk.network/developer/contribute/grants/
 
-### Operators
+### Operate
 
 - Operator Overview: https://docs.dusk.network/operator/overview/
 - Provisioner Node: https://docs.dusk.network/operator/provisioner/
@@ -117,13 +118,15 @@ Relevant docs:
 - Maintenance & Monitoring: https://docs.dusk.network/operator/maintenance-monitoring/
 - Troubleshooting: https://docs.dusk.network/operator/troubleshooting/
 
-### User Tools
+### Use Dusk
 
-- Web Wallet: https://docs.dusk.network/learn/web-wallet/
-- Rusk Wallet: https://docs.dusk.network/learn/rusk-wallet/
-- Block Explorer: https://docs.dusk.network/learn/block-explorer/
+- Use Dusk Overview: https://docs.dusk.network/use/overview/
+- Wallets: https://docs.dusk.network/use/wallets/
+- Explorers: https://docs.dusk.network/learn/block-explorer/
 - Staking: https://docs.dusk.network/learn/guides/staking-basics/
 - DuskEVM Bridge: https://docs.dusk.network/learn/guides/duskevm-bridge/
+- Mainnet Migration: https://docs.dusk.network/learn/guides/mainnet-migration/
+- BEP20 Bridge: https://docs.dusk.network/learn/guides/bep20-bridge/
 
 ## Naming Guidance
 

public/llms.txt

@@ -5,23 +5,27 @@
 ## Start Here
 
 - [Overview](https://docs.dusk.network/learn/overview/): high-level introduction to Dusk.
+- [Use Dusk](https://docs.dusk.network/use/overview/): choose a wallet, manage DUSK, stake, bridge, and inspect transactions.
+- [Build on Dusk](https://docs.dusk.network/developer/overview/): choose a smart-contract or integration path.
+- [Operate Dusk](https://docs.dusk.network/operator/overview/): choose, set up, and maintain Dusk infrastructure.
 - [Market Infrastructure](https://docs.dusk.network/learn/market-infrastructure/): how Dusk supports regulated asset workflows.
 - [Dusk Trade](https://docs.dusk.network/learn/dusk-trade/): product layer for tokenized financial asset workflows on Dusk.
 - [Core Components](https://docs.dusk.network/learn/core-components/): DuskDS, Rusk, DuskVM, DuskEVM, Citadel, and application-layer tooling.
 - [Core Values](https://docs.dusk.network/learn/core-values/): regulated workflows, access controls, selective disclosure, and deterministic settlement.
 - [Native Issuance](https://docs.dusk.network/learn/tokenization-comparison/): digitization, tokenization, and native issuance.
 
-## Developer Docs
+## Build
 
 - [Build on Dusk](https://docs.dusk.network/developer/overview/): choose between DuskVM and DuskEVM development.
 - [DuskEVM Quickstart](https://docs.dusk.network/developer/duskevm/quickstart/): deploy Solidity contracts on DuskEVM.
 - [DuskVM Overview](https://docs.dusk.network/developer/duskvm/overview/): understand Rust/WASM contracts that execute directly on the Dusk L1.
 - [DuskVM Quickstart](https://docs.dusk.network/developer/duskvm/quickstart/): create, test, build, and deploy a DuskVM contract.
 - [DuskVM Contract Reference](https://docs.dusk.network/developer/duskvm/reference/): understand the DuskVM contract, ABI, state, event, and deployment model.
 - [Dusk Connect](https://docs.dusk.network/developer/integrations/dusk-connect/): discover wallet extensions, request profile access, and submit user-approved transactions from browser dApps.
-- [Dusk Wallet Extension](https://docs.dusk.network/developer/integrations/wallet-extension/): integrate with the first-party browser wallet provider.
+- [Dusk Wallet Integration](https://docs.dusk.network/developer/integrations/wallet-extension/): integrate applications with the first-party browser wallet provider.
 - [Transaction Lifecycle](https://docs.dusk.network/developer/integrations/tx-lifecycle/): understand transaction flow.
 - [HTTP API](https://docs.dusk.network/developer/integrations/http-api/): integrate with Dusk APIs.
+- [Historical Events](https://docs.dusk.network/developer/integrations/historical_events/): query finalized public transfer history from archive infrastructure.
 - [W3sper SDK](https://docs.dusk.network/developer/integrations/w3sper/): SDK integration.
 
 ## Learn
@@ -32,12 +36,19 @@
 - [Assets & Regulations](https://docs.dusk.network/learn/deep-dive/assets-and-regulations/): regulated asset workflow concepts.
 - [Cryptography](https://docs.dusk.network/learn/cryptography/): zero-knowledge proofs and cryptographic building blocks.
 
-## Operators and Tools
+## Use Dusk
+
+- [Use Dusk Overview](https://docs.dusk.network/use/overview/): find wallets, staking, bridge, migration, and explorer guides.
+- [Wallets](https://docs.dusk.network/use/wallets/): compare Dusk Wallet, Web Wallet, Rusk Wallet, and community alternatives.
+- [Explorers](https://docs.dusk.network/learn/block-explorer/): find official mainnet and testnet explorers and community alternatives.
+- [Staking](https://docs.dusk.network/learn/guides/staking-basics/): stake DUSK and participate in consensus.
+- [DuskEVM Bridge](https://docs.dusk.network/learn/guides/duskevm-bridge/): move testnet DUSK between the Dusk L1 and DuskEVM.
+
+## Operate
 
 - [Operator Overview](https://docs.dusk.network/operator/overview/): run and maintain Dusk infrastructure.
+- [Networks](https://docs.dusk.network/operator/networks/): choose a Dusk network environment.
 - [Provisioner Node](https://docs.dusk.network/operator/provisioner/): run a provisioner node.
-- [Web Wallet](https://docs.dusk.network/learn/web-wallet/): use Dusk in the browser.
-- [Block Explorer](https://docs.dusk.network/learn/block-explorer/): inspect public network data.
 
 ## Full Context
 

src/components/ResourceLinksGrid.astro

@@ -4,23 +4,23 @@ import { LinkCard, CardGrid } from "@astrojs/starlight/components";
 
 <CardGrid>
     <LinkCard
-        title="Node Setup"
-        href="/operator/overview"
-        description="Learn how to setup your own Dusk node and get ready to join the network."
+        title="Learn"
+        href="/learn/overview"
+        description="Understand Dusk's purpose, architecture, execution environments, and market infrastructure."
     />
     <LinkCard
-        title="Digital Identity"
-        href="/developer/digital-identity/protocol"
-        description="Check out Dusk's privacy-preserving self-sovereign identity protocol."
+        title="Use Dusk"
+        href="/use/overview"
+        description="Choose a wallet, manage DUSK, stake, bridge between networks, and inspect transactions."
     />
     <LinkCard
-        title="Tokenomics"
-        href="/learn/tokenomics"
-        description="Learn how DUSK is used for fees and staking, and how emissions and rewards work."
+        title="Build"
+        href="/developer/overview"
+        description="Build with DuskVM or DuskEVM and integrate wallets, SDKs, APIs, and protocol capabilities."
     />
     <LinkCard
-        title="DuskVM Contract Example"
-        href="/developer/duskvm/quickstart/"
-        description="Create, test, build, and deploy a Rust/WASM contract with Forge."
+        title="Operate"
+        href="/operator/overview"
+        description="Choose a network and node role, then set up, maintain, monitor, and recover Dusk infrastructure."
     />
 </CardGrid>

src/content/docs/developer/duskvm/overview.md

@@ -22,7 +22,7 @@ Both environments are general-purpose. DuskVM executes contracts directly on the
 |---|---|
 | [Forge](https://github.com/dusk-network/forge) | Scaffolds contracts and generates ABI exports, schemas, and data drivers from annotated Rust |
 | [DuskVM](/learn/deep-dive/dusk-vm/) | Executes contract WASM and persists contract state |
-| [Rusk Wallet](/learn/rusk-wallet/) | Signs and submits deployment and contract-call transactions |
+| [Rusk Wallet](/use/wallets/#rusk-wallet) | Signs and submits deployment and contract-call transactions |
 | [Dusk Connect](/developer/integrations/dusk-connect/) | Connects browser dApps to compatible Dusk wallet extensions for account access and transaction approval |
 | [W3sper](/developer/integrations/w3sper/) | Connects JavaScript applications to Dusk nodes and contract data drivers |
 

src/content/docs/developer/duskvm/quickstart.md

@@ -80,7 +80,7 @@ Keep the `0x` prefix when an SDK expects prefixed hex. Remove it for `rusk-walle
 
 ## 5. Deploy on testnet
 
-Install and configure [Rusk Wallet](/learn/rusk-wallet/) and make sure a public account has enough testnet DUSK for deployment. [Request funds from the testnet faucet](/operator/networks/#how-to-get-testnet-tokens) if needed. The commands below target testnet explicitly and use the wallet's first address by default; add `--address <ADDRESS>` to use another funded address. Testnet DUSK has no monetary value.
+Install and configure [Rusk Wallet](/use/wallets/#rusk-wallet) and make sure a public account has enough testnet DUSK for deployment. [Request funds from the testnet faucet](/operator/networks/#how-to-get-testnet-tokens) if needed. The commands below target testnet explicitly and use the wallet's first address by default; add `--address <ADDRESS>` to use another funded address. Testnet DUSK has no monetary value.
 
 Deploy the on-chain artifact with a nonce you have not used for the same contract and account:
 

src/content/docs/developer/duskvm/reference.md

@@ -118,6 +118,6 @@ Both deployment and contract calls submitted as transactions consume gas, whethe
 - [Forge source and releases](https://github.com/dusk-network/forge)
 - [DuskVM source](https://github.com/dusk-network/rusk/tree/master/vm)
 - [Dusk contract ABI](https://docs.rs/dusk-core/latest/dusk_core/abi/)
-- [Rusk Wallet](/learn/rusk-wallet/)
+- [Rusk Wallet](/use/wallets/#rusk-wallet)
 - [Dusk Connect](/developer/integrations/dusk-connect/)
 - [W3sper SDK](/developer/integrations/w3sper/)

src/content/docs/developer/integrations/wallet-extension.md

@@ -1,9 +1,11 @@
 ---
-title: Dusk Wallet Extension
-description: Use the Dusk Wallet browser extension as a first-party wallet for Dusk applications.
+title: Dusk Wallet Integration
+description: Connect applications to the official Dusk Wallet extension and its provider API.
 ---
 
-The Dusk Wallet extension is the first-party browser wallet for Dusk. It gives users a self-custodial wallet in Chrome and Firefox, and gives applications a provider surface for connecting Dusk accounts.
+This page is for developers integrating with or building the Dusk Wallet extension. For installation and user guidance, see [Wallets](/use/wallets/#dusk-wallet).
+
+The Dusk Wallet extension is the first-party browser wallet for Dusk. It gives applications a provider surface for connecting Dusk accounts.
 
 Use the extension when you need:
 
@@ -13,7 +15,7 @@ Use the extension when you need:
 - dApp connection through Dusk provider discovery
 - a first-party wallet to test Dusk Connect integrations
 
-For users who only need a hosted browser wallet, see [Web Wallet](/learn/web-wallet). For terminal and operator workflows, see [Rusk Wallet](/learn/rusk-wallet).
+For a hosted browser wallet or terminal and operator workflows, see [Wallets](/use/wallets/).
 
 ## How it fits with Dusk Connect
 
@@ -80,4 +82,4 @@ Then load `dist-firefox/` as a temporary add-on in `about:debugging`.
 
 - [Dusk Connect](/developer/integrations/dusk-connect)
 - [Transaction Lifecycle](/developer/integrations/tx-lifecycle)
-- [Web Wallet](/learn/web-wallet)
+- [Wallets](/use/wallets/)

src/content/docs/developer/overview.mdx

@@ -29,9 +29,9 @@ As a builder, choose the path based on what your product needs and which tooling
     description="Write general-purpose Rust/WASM contracts that execute directly on the Dusk L1."
   />
   <LinkCard
-    title="Integrate a Dusk dApp"
+    title="Integrate Wallets and APIs"
     href="/developer/integrations/dusk-connect"
-    description="Connect wallet extensions with Dusk Connect, and use W3sper or HTTP APIs for direct network access."
+    description="Connect wallet extensions with Dusk Connect, then use W3sper or HTTP APIs for network access."
   />
   <LinkCard
     title="Dusk Improvement Proposals"

src/content/docs/index.mdx

@@ -3,12 +3,12 @@ title: Dusk Documentation
 description: Documentation for Dusk, infrastructure for regulated digital assets, privacy, and deterministic settlement.
 template: splash
 hero:
-  tagline: "Build, integrate, and operate on Dusk: institutional-grade infrastructure for regulated digital assets and general finance."
+  tagline: "Understand, use, build on, and operate infrastructure for regulated digital assets and general finance."
   image:
     light: ../../assets/hero-light.svg
     dark: ../../assets/hero-dark.svg
   actions:
-    - text: Start learning
+    - text: Explore Dusk
       link: /learn/overview/
       icon: right-arrow
       variant: primary

src/content/docs/learn/block-explorer.md

@@ -1,9 +1,24 @@
 ---
-title: Block Explorer
-description: Use the Dusk block explorer to look up transactions, blocks, and fees.
+title: Explorers
+description: Find official and community explorers for Dusk mainnet and testnet.
 ---
 
-You can view transactions and blocks on the <a href="https://explorer.dusk.network/" target="_blank" rel="noreferrer">Dusk Block Explorer</a>.
+Explorers let you inspect public network data such as blocks, transactions, contracts, provisioners, fees, and gas usage.
+
+## Official explorers
+
+| Network | Explorer |
+|---|---|
+| Dusk mainnet | [explorer.dusk.network](https://explorer.dusk.network/) |
+| Dusk testnet | [apps.testnet.dusk.network/explorer](https://apps.testnet.dusk.network/explorer/) |
+
+`explorer.dusk.network` is the canonical mainnet address and redirects to the explorer hosted under `apps.dusk.network`.
+
+## Community explorers
+
+[DuskExplorer.com](https://duskexplorer.com/), also known as **The DUDE**, is a community-operated mainnet explorer. It is not operated by Dusk. Community explorers may expose different indexes, labels, statistics, or wallet integrations, so verify important information against an official endpoint when needed.
+
+## What explorers can show
 
 Dusk is a privacy-preserving blockchain. Privacy-preserving [Phoenix](/learn/deep-dive/duskds-tx-models) transactions do not expose the sender, receiver and amount transferred to anyone other than the involved parties (sender, receiver, and users with the view key).
 

src/content/docs/learn/dusk-trade.md

@@ -55,4 +55,4 @@ Dusk Trade is where those requirements become a usable product surface.
 - [Native Issuance](/learn/tokenization-comparison)
 - [Assets & Regulations](/learn/deep-dive/assets-and-regulations)
 - [Dusk Connect](/developer/integrations/dusk-connect)
-- [Dusk Wallet Extension](/developer/integrations/wallet-extension)
+- [Wallets](/use/wallets)

src/content/docs/learn/ecosystem.mdx

@@ -1,47 +1,65 @@
 ---
-title: Ecosystem & Partners
-description: Explore applications, tools, and partners in the Dusk ecosystem.
+title: Ecosystem
+description: Explore community applications, tools, initiatives, and integrations in the Dusk ecosystem.
 ---
 
 import { LinkCard, CardGrid } from '@astrojs/starlight/components';
 
-Dusk’s ecosystem spans on‑chain applications, user tools, and institutional partners.  
-This page highlights a selection of projects building on or integrating with Dusk.
+Dusk's ecosystem includes applications, wallets, network tools, community initiatives, and institutional integrations.
 
-Some of the services listed here are community‑operated or third‑party products.
-Always do your own due diligence before using them.
+Listings are informational, not endorsements. Community and third-party projects are operated independently from Dusk; verify their ownership, security, and current status before using them.
 
-## On‑chain apps & DeFi
+## Applications and protocols
 
 <CardGrid>
   <LinkCard
     title="Sozu"
     href="https://sozu.fi/"
-    description="Dusk staking platform. Stake DUSK to help secure the network and earn rewards."
+    description="Community staking platform for participating in Dusk staking without operating your own infrastructure."
   />
   <LinkCard
     title="Pieswap"
     href="https://pieswap.app/"
-    description="Decentralized exchange on DuskEVM. Swap tokens, provide liquidity, and earn fees."
+    description="Community decentralized exchange on DuskEVM for swaps and liquidity."
+  />
+  <LinkCard
+    title="Dusk Domains"
+    href="https://dusk.domains/"
+    description="Community .dusk name service for Dusk wallets, contracts, and applications."
   />
 </CardGrid>
 
-## Tools & explorers
+## Wallets and network tools
 
 <CardGrid>
+  <LinkCard
+    title="Piewallet"
+    href="https://chromewebstore.google.com/detail/piewallet/fpaajdmdhkhfedemboncmcmckkhnnike"
+    description="Community browser wallet from Piecrust for Pieswap and Dusk-compatible networks."
+  />
+  <LinkCard
+    title="The DUDE"
+    href="https://duskexplorer.com/"
+    description="Community-operated explorer for Dusk L1 transactions, blocks, contracts, and provisioners."
+  />
   <LinkCard
     title="Dusk Dashboard"
     href="https://duskdashboard.com/"
-    description="Monitor stakes, unstakes, restakes, provisioner info, yields and earnings."
+    description="Community dashboard for Dusk stake, provisioner, yield, and network activity."
   />
+</CardGrid>
+
+## Community
+
+<CardGrid>
   <LinkCard
-    title="Dusk Explorer"
-    href="https://duskexplorer.com/"
-    description="Community‑operated explorer for Dusk L1 transactions and blocks."
+    title="OpenDusk"
+    href="https://opendusk.org/"
+    description="Community-led forum and initiative for ecosystem discussion, participation, and growth."
   />
 </CardGrid>
 
-## Infrastructure & partners
+## Integrations and partners
 
 <CardGrid>
   <LinkCard

src/content/docs/learn/glossary.md

@@ -97,7 +97,7 @@ RUES (Rusk Universal Event System) is the event system used to stream chain even
 
 #### Rusk Wallet
 
-The [Rusk Wallet](/learn/rusk-wallet) is the official CLI wallet for Dusk.
+The [Rusk Wallet](/use/wallets#rusk-wallet) is the official CLI wallet for Dusk.
 
 #### Shielded Account
 
@@ -113,7 +113,7 @@ Succinct Attestation is Dusk's proof-of-stake consensus protocol.
 
 #### Web Wallet
 
-The [Web Wallet](/learn/web-wallet) is the official browser-based wallet for Dusk.
+The [Web Wallet](/use/wallets#web-wallet) is Dusk's official hosted browser wallet interface.
 
 #### Zedger