Restructure the Guides section into journey-ordered story pages

.vale.ini

@@ -13,4 +13,4 @@ IgnoredPaths = **/_*
 # Markdown and MDX
 [*.{md,mdx}]
 BasedOnStyles = Midnight
-TokenIgnores = (?s)<!--truncate-->, (?s)\{/\*.*?\*/\}
+TokenIgnores = (?s)<!--truncate-->, (?s)\{/\*.*?\*/\}, (\{#[-\w]+\})

docs/examples/_bboard/local-testing.mdx

@@ -82,15 +82,15 @@ cleaned up automatically.
 When you are ready to try out your DApp on the Midnight Testnet, be
 sure you have not left it running and that your standalone Docker
 configuration has exited. Then,
-[start your proof server](../../guides/run-proof-server.mdx) again. When it is
+[start your proof server](../../guides/development-environment.mdx#run-the-proof-server) again. When it is
 ready, start the DApp with this command:
 
 ```shell
 yarn testnet-remote
 ```
 
 This time, you will need real tDUST, so either create a new wallet and
-transfer some tDUST to it from your [Lace wallet](../../guides/lace-wallet.mdx),
+transfer some tDUST to it from your [Lace wallet](/getting-started/installation),
 or look back at the logs from your experiments with the counter DApp in part 2 to
 find the seed for your headless wallet:
 

docs/getting-started/quickstart.mdx

@@ -121,7 +121,7 @@ export circuit storeMessage(customMessage: Opaque<"string">): [] {
 
 [Compact](../compact/) is Midnight's smart contract language used to define contract logic. It is similar to TypeScript but is designed for use with the Midnight runtime.
 
-The `docker-compose.yml` file defines a local devnet, a Midnight node, indexer, and [proof server](../guides/run-proof-server) that runs in Docker. The proof server generates Zero Knowledge (ZK) proofs for smart contracts on the Midnight network. The devnet must be running before you can deploy or interact with the contract.
+The `docker-compose.yml` file defines a local devnet, a Midnight node, indexer, and [proof server](../guides/development-environment#run-the-proof-server) that runs in Docker. The proof server generates Zero Knowledge (ZK) proofs for smart contracts on the Midnight network. The devnet must be running before you can deploy or interact with the contract.
 
 ## Set up the project
 

docs/guides/_category_.yaml

@@ -3,6 +3,5 @@ label: 'Guides'
 collapsible: true # make the category collapsible
 collapsed: true # keep the category closed by default
 link:
-  type: generated-index
-  title: Guides
-  description: Step-by-step guides for building on Midnight Network.
+  type: doc
+  id: guides/index

docs/guides/acquire-tokens.mdx

@@ -1,31 +1,32 @@
 ---
 SPDX-License-Identifier: Apache-2.0
 copyright: This file is part of midnight-docs. Copyright (C) Midnight Foundation. Licensed under the Apache License, Version 2.0 (the "License"); You may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
-sidebar_label: "Get faucet tokens"
-description: Learn how to acquire test tokens for the Midnight Network.
+title: Fund your wallet
+sidebar_label: "Fund your wallet"
+description: Get tNIGHT from the faucet and delegate it to generate the tDUST that pays for transactions on the Midnight test networks.
 toc_max_heading_level: 2
-sidebar_position: 15
+sidebar_position: 2
 ---
 
-# Get faucet tokens
+# Fund your wallet
 
-In the production Midnight network, to run a DApp you need
+With your [development environment set up](./development-environment), the next thing you need is tokens. In the production Midnight network, to run a DApp you need
 to hold some DUST in a persistent wallet and spend some of it on each
 transaction. However, a supply of free tDUST is
 available for developers who want to experiment with Midnight DApps.
 
 :::tip
-If you are using the local undeployed network, then use the [local network faucet](./midnight-local-network#fund-wallets) to fund your wallet and generate tDUST.
+If you are using the local undeployed network, then use the [local network faucet](./local-to-testnet#fund-wallets) to fund your wallet and generate tDUST.
 :::
 
-## Get tNIGHT
+## Get tNIGHT {#get-tnight}
 
 tNIGHT is the test token for the Midnight network. It is used to generate tDUST for testing purposes. Here are the steps to get tNIGHT:
 
 1. Log in to your Lace Midnight wallet and copy your Unshielded wallet address.
 
   :::note Bech32m address format
-  All wallet addresses are shown in Bech32m format by default. The faucet supports both formats, however the legacy (HEX) format will be dropped in future versions.
+  All wallet addresses are shown in Bech32m format by default. The faucet also accepts the legacy (HEX) format, but prefer Bech32m.
   :::
 
 2. Visit [Midnight Preprod faucet](https://midnight-tmnight-preprod.nethermind.dev/) and enter your Unshielded wallet address.
@@ -40,7 +41,7 @@ Transaction submitted. You will receive 1000 tNight, this should take about 2 mi
 
 You should have received 1000.0 tNIGHT from the faucet. You can verify the balance in your wallet.
 
-## Delegate tDUST
+## Delegate tDUST {#delegate-tdust}
 
 After you have received tNIGHT, you need to delegate it to generate tDUST. Here's how to do it if you are using the Lace wallet:
 
@@ -56,6 +57,10 @@ You should see your tDUST tank generating test tokens for your wallet.
 
 ![Confirm transaction](./img/dust-tank-generation.png)
 
+:::tip
+If your application creates wallets from code, you can also [generate DUST programmatically](./generating-dust-programmatically) with the Wallet SDK instead of using the Lace UI.
+:::
+
 ## Troubleshooting
 
 Below are some common issues you might encounter when using the faucet and how to resolve them.
@@ -68,6 +73,10 @@ Below are some common issues you might encounter when using the faucet and how t
 
 ### Rate limit exceeded
 
-- **Error**: `{“status”:“rate_limit_error”,“message”:“Reached maximum number of requests for this address”}`
+- **Error**: `{"status":"rate_limit_error","message":"Reached maximum number of requests for this address"}`
+
+- **Solution**: Wait a few hours and try again. If the issue persists, then open a ticket at the [Midnight Service Desk](https://midnightntwrk.github.io/servicedesk/) or ask for help in the [Midnight Discord server](https://discord.com/invite/midnightnetwork).
+
+## Next steps {#next-steps}
 
-- **Solution**: Wait a few hours and try again. If the issue persists, then open a ticket at the [Midnight Service Desk](https://midnightntwrk.github.io/servicedesk/) or ask for help in the [Midnight Discord server](https://discord.gg/midnightnetwork).
+With tNIGHT in your wallet and tDUST generating, you are ready to build and deploy: continue with [from local network to testnet](./local-to-testnet).