Installation (#909)

* added examples back in

* installation revisions + standardization

* comments

* comments

Author: lrobledo

apps/web/content/docs/en/intro/installation/anchor-cli-basics.mdx

@@ -5,43 +5,41 @@ description:
   This section walks through some common Anchor CLI commands to get you started.
 ---
 
-This section walks through some common Anchor CLI commands to get you started.
-For more information on the Anchor CLI, see the
-[Anchor documentation](https://www.anchor-lang.com/docs).
+This section provides some common commands and examples to help you get started
+using the [Anchor CLI](https://www.anchor-lang.com/docs).
 
 <Steps>
 <Step>
 
-### Initialize Project
+### Initialize the project
 
-To create a new Anchor project, run the following command:
+Create a new Anchor project by running the command shown below.
+It will create a new directory with the project name and use it to
+initialize a new Anchor project.
 
 ```terminal
 $ anchor init <project-name>
 ```
 
-For example, to create a project called `my-project`, run:
+For example, the command below will create a project called `my-project`.
+The `my-project` directory will contain a basic Rust program and TypeScript test template.
 
 ```terminal
 $ anchor init my-project
 ```
 
-This command creates a new directory with the project name and initializes a new
-Anchor project with a basic Rust program and TypeScript test template.
-
-Navigate to the project directory:
+Then navigate to the project directory:
 
 ```terminal
 $ cd <project-name>
 ```
 
-See the Anchor project's
-[file structure](https://www.anchor-lang.com/docs/quickstart/local#project-file-structure).
+See Anchor's [project file structure](https://www.anchor-lang.com/docs/quickstart/local#project-file-structure).
 
 </Step>
-
 <Step>
-### Build Program
+
+### Build the program
 
 To build your project, run the following command:
 
@@ -101,7 +99,7 @@ again.
 </Step>
 <Step>
 
-### Deploy Program
+### Deploy the program
 
 To deploy your project, run the following command:
 
@@ -115,28 +113,24 @@ This command deploys your program to the `cluster` specified in the
 </Step>
 <Step>
 
-### Test Program
+### Test the program
 
 To test your project, run the following command:
 
 ```terminal
 $ anchor test
 ```
 
-<Callout>
-
 This command builds, deploys, and runs the tests for your project.
 
-When using `localnet` as the `cluster` in `Anchor.toml`, Anchor automatically
-starts a local validator, deploys your program, runs tests, and then stops the
-validator.
-
+<Callout>
+When using the `localnet` cluster, Anchor automatically starts a local validator,
+deploys the program, runs tests, then stops the validator.
 </Callout>
 
 <Callout type="warn">
 
-When running _shell`anchor test`_ after creating a new Anchor project on Linux
-or WSL, you may encounter the following errors if you don't have Node.js or Yarn
+Either of the following errors may indicate that you don't have Node.js or Yarn
 installed:
 
 ```

apps/web/content/docs/en/intro/installation/dependencies.mdx

@@ -488,7 +488,7 @@ anchor-cli 0.31.1
 </Step>
 </Steps>
 
-### Setting up AI Tooling for Solana development
+### Set up AI tooling for Solana development
 
 This section details optional AI tooling setup you can use to accelerate your
 Solana development.

apps/web/content/docs/en/intro/installation/index.mdx

@@ -143,7 +143,7 @@ $ curl --proto '=https' --tlsv1.2 -sSfL https://solana-install.solana.workers.de
 
 A successful installation will return output like the following:
 
-```
+```txt title="Example output"
 Installed Versions:
 Rust: rustc 1.90.0 (1159e78c4 2025-09-14)
 Solana CLI: solana-cli 2.3.13 (src:5466f459; feat:2142755730, client:Agave)
@@ -164,9 +164,3 @@ $ rustc --version && solana --version && anchor --version && node --version && y
   Dependencies](/docs/intro/installation/dependencies) section below for
   instructions to install each dependency individually.
 </Callout>
-
-### Next steps
-
-Once you have installed all the necessary dependencies, you are ready to review
-the [Solana CLI Basics](/docs/intro/installation/solana-cli-basics) and
-[Anchor CLI Basics](/docs/intro/installation/anchor-cli-basics).

apps/web/content/docs/en/intro/installation/solana-cli-basics.mdx

@@ -5,31 +5,40 @@ description:
   This section walks through some common Solana CLI commands to get you started.
 ---
 
-<Steps>
-<Step>
+This section provides some common commands and examples
+to help you get you started using the Solana CLI.
 
-### Solana Config
+## Solana config
 
-To see your current config:
+Your Solana config specifies the following variables:
+
+- **Config file**: The path to your config file
+- **RPC URL & Websocket URL**: The Solana cluster to which the CLI makes requests
+- **Keypair path**:
+  The path to the default Solana wallet (keypair) used to pay transaction fees and deploy programs.
+  By default, this file is stored at `~/.config/solana/id.json`.
+
+To see your current configuration settings, enter the follow command in your terminal.
 
 ```terminal
 $ solana config get
 ```
 
-You should see output like the following:
+A successful command will return output similar to the following:
 
-```
+```txt title="Example output"
 Config File: /Users/test/.config/solana/cli/config.yml
 RPC URL: https://api.mainnet-beta.solana.com
 WebSocket URL: wss://api.mainnet-beta.solana.com/ (computed)
 Keypair Path: /Users/test/.config/solana/id.json
 Commitment: confirmed
 ```
 
-The RPC URL and Websocket URL specify the Solana cluster the CLI makes requests
-to.
+You can change the Solana CLI cluster with the following commands:
 
-You can update the Solana CLI cluster using the following commands:
+<Tabs items={["Full commands", "Short commands"]}>
+
+<Tab value="Full commands">
 
 ```terminal
 $ solana config set --url mainnet-beta
@@ -38,7 +47,8 @@ $ solana config set --url localhost
 $ solana config set --url testnet
 ```
 
-You can also use the following short options:
+</Tab>
+<Tab value="Short commands">
 
 ```terminal
 $ solana config set -um    # For mainnet-beta
@@ -47,27 +57,23 @@ $ solana config set -ul    # For localhost
 $ solana config set -ut    # For testnet
 ```
 
-The Keypair Path points to the default Solana wallet (keypair) used by the
-Solana CLI to pay transaction fees and deploy programs. By default, this file is
-stored at `~/.config/solana/id.json`.
-
-</Step>
-<Step>
+</Tab>
+</Tabs>
 
-### Create Wallet
+## Create a wallet
 
-To send transactions using the Solana CLI, you need a Solana wallet funded with
-SOL.
+Before you can send a transactions using the Solana CLI,
+you need a Solana wallet funded with SOL.
 
-To generate a keypair at the default Keypair Path, run the following command:
+To generate a keypair at the default keypair path, run the following command:
 
 ```terminal
 $ solana-keygen new
 ```
 
-You should see output like the following:
+A successful command will return output similar to the following:
 
-```
+```txt title="Example output"
 Generating a new keypair
 
 For added security, enter a BIP39 passphrase
@@ -87,11 +93,8 @@ cream bleak tortoise ocean nasty game gift forget fancy salon mimic amazing
 ```
 
 <Callout type="info">
-
-If you already have a file system wallet saved at the default location, this
-command doesn't override it unless you explicitly force override using the
-`--force` flag.
-
+This command will not override an existing account at the default location,
+unless you use the `--force` flag.
 </Callout>
 
 To view your wallet's address (public key), run:
@@ -100,21 +103,18 @@ To view your wallet's address (public key), run:
 $ solana address
 ```
 
-</Step>
-<Step>
-
-### Airdrop SOL
+## Airdrop SOL
 
 Request an airdrop of SOL to your wallet to pay for transactions and program
 deployments.
 
-Set your cluster to the devnet:
+1. Set your cluster to Devnet:
 
 ```terminal
 $ solana config set -ud
 ```
 
-Then request an airdrop of devnet SOL:
+2. Request an airdrop of Devnet SOL:
 
 ```terminal
 $ solana airdrop 2
@@ -133,31 +133,20 @@ To check your wallet's SOL balance, run the following command:
 $ solana balance
 ```
 
-</Step>
-<Step>
-
-### Run Local Validator
+## Run local validator
 
 The Solana CLI includes a built-in
 [test validator](https://docs.anza.xyz/cli/examples/test-validator) for local
 development.
 
-In a separate terminal, run the following command to start a local validator:
+Open a new terminal and update your CLI to use localhost:
 
 ```terminal
-$ solana-test-validator
+$ solana config set -ul
 ```
 
-<Callout>
-
-Remember to also update your CLI to use localhost before running Solana CLI
-commands:
+Run the following command to start a local validator:
 
 ```terminal
-$ solana config set -ul
+$ solana-test-validator
 ```
-
-</Callout>
-
-</Step>
-</Steps>

apps/web/content/docs/en/intro/quick-start/index.mdx

@@ -11,16 +11,14 @@ Welcome to the Solana quick start guide! This hands-on guide will introduce you
 to the **Solana Playground** (Solpg), where you can learn core-concepts,
 regardless of your prior experience. In this tutorial, you will learn about:
 
-- **Solana Accounts**: How the Solana network stores data
-- **Sending Transactions**: How to interact with the Solana network by sending
+- **Solana accounts**: How the Solana network stores data
+- **Sending transactions**: How to interact with the Solana network by sending
   transactions
-- **Building and Deploying Programs**: Create your first Solana program and
+- **Building and deploying programs**: Create your first Solana program and
   deploy it to the network
-- **Program Derived Addresses (PDAs)**: Learn how to use PDAs to create
-  deterministic addresses for accounts
-- **Cross-Program Invocations (CPIs)**: Learn how to call other programs from
-  within your program, enabling complex interactions and composability between
-  different programs on Solana
+- **Program-Derived addresses**: Learn how to create deterministic addresses for accounts
+- **Cross-Program Invocations**: Learn how to call other programs from
+  within your program, enabling complex interactions and program composability
 
 ## The Solana Playground
 
@@ -35,7 +33,7 @@ create a Playground [wallet](/docs/references/terminology#wallet) and add
 [SOL](/docs/references/terminology#sol). This wallet will allow you to interact
 with the Solana network directly from your browser.
 
-## Create a Playground Wallet
+## Create a Playground wallet
 
 <Steps>
 <Step>
@@ -57,7 +55,7 @@ Click the 🔴 **Not connected** text at the bottom left corner of the screen.
 </Step>
 <Step>
 
-### Save your Keypair
+### Save your keypair
 
 Click **Save keypair** to save your key pair locally. When you're ready, click
 **Continue**.
@@ -89,7 +87,7 @@ SOL to your wallet.
 </Step>
 <Step>
 
-### Add SOL to Your Wallet
+### Add SOL to your wallet
 
 Before starting development, you need to add devnet SOL to your wallet. As a
 developer, SOL is used for two main use cases:
@@ -100,15 +98,15 @@ developer, SOL is used for two main use cases:
 You can add devnet SOL to your wallet using the Playground terminal or with the
 Devnet Faucet. Each option is described below:
 
-#### Option 1: Use the Playground Terminal
+#### Option 1: Use the Playground terminal
 
 Run the following command in the Playground terminal:
 
 ```terminal
 $ solana airdrop 5
 ```
 
-#### Option 2: Use the Devnet Faucet
+#### Option 2: Use the Devnet faucet
 
 If option 1 fails, due to rate limits or other errors, use Solana's
 [Web Faucet](https://faucet.solana.com/).
@@ -121,9 +119,3 @@ If option 1 fails, due to rate limits or other errors, use Solana's
 
 </Step>
 </Steps>
-
-## Next Steps
-
-Now that you have created a Playground wallet and added Devnet SOL, you are
-ready to
-[read from the Solana network](/docs/intro/quick-start/reading-from-network).