Update readme with latest dev steps (#2168)

Author: jsdw

DEPLOY-RELEASE.md

@@ -1,16 +1,15 @@
 # Deploying docs and releasing substrate connect
 
-## Releasing
-
-TODO
+TODO: This is out of date. Update this to reflect the new release steps once we
+get to doing a release.
 
 ## Deploy Smoldot browser demo to Github Pages
 
 Before deploying make sure you have a clean working copy with no staged changes.
 The deploy script will deploy the last commit on your current branch.
 
-The deployment will build the smoldot browser demo into the dist folder and 
-construct a commit containing just that folder with a message containing a 
+The deployment will build the smoldot browser demo into the dist folder and
+construct a commit containing just that folder with a message containing a
 reference to the SHA of the commit it came from and push that to the gh-pages
 branch. The dist folder remains ignored by git.
 

README.md

@@ -7,7 +7,7 @@ securely connect to the blockchain network without relying on specific 3rd parti
 
 Due to browser limitations on websockets from https pages, establishing a good
 number of peers is difficult as many nodes need to be available with TLS.  Substrate
-connect provides a browser extension to overcome this limitation and to keep 
+connect provides a browser extension to overcome this limitation and to keep
 the chains synced in the background, which makes your apps faster.
 
 When building an app with substrate connect, it will detect whether the user has
@@ -23,30 +23,31 @@ The substrate connect [API documentation is published here](https://paritytech.g
 
 This repository is using [pnpm workspaces](https://pnpm.io/workspaces).
 
-We are tracking our work and milestones in a [github project](https://github.com/paritytech/substrate-connect/projects/1).
+We also use `corepack`, which ensures that the correct version of `pnpm` is used.
 
 Please see our [contributing guidelines](./CONTRIBUTING.md) for details on how
 we like to work and how to smoothly contribute to the project.
 
-## Getting Started
-
-1. Clone the whole `substrate-connect` repository.
-
-```bash
-git clone https://github.com/paritytech/substrate-connect.git
-```
-
-2. Install all dependencies
-
-```bash
-corepack pnpm install
-```
-
-3. Compile all packages and projects
-
-```bash
-corepack pnpm build
-```
+### Getting Started
+
+If you're hacking on this repository, here's how to install everything and spin up a demo:
+
+1. Install any prerequisites. These steps were tested with:
+   - Node.js (node) v20.9.0.
+   - pnpm 9.0.6 (`npm install -g pnpm`).
+   - corepack 0.20.0 (This should be bundled with recent Node.js versions).
+2. Clone the repository.
+   - `git clone https://github.com/paritytech/substrate-connect.git`
+   - `cd substrate-connect` to navigate to the repository root.
+3. Install the dependencies.
+   - `corepack pnpm install`
+4. In terminal A, run `cd projects/extension && corepack pnpm dev`.
+5. In terminal B, run `cd projects/extension && corepack pnpm start`.
+   - This will open a Chrome browser window with the extension pre-loaded.
+   - Make sure that the extension is running.
+6. In terminal C, run `cd projects/demo && corepack pnpm dev`.
+   - Navigate to the URL that this logs in the Chrome browser that opened in 5.
+   - You should see the extension come to life and the demo app log latest blocks.
 
 To clean up all build artefacts in workspaces in the repository, run:
 
@@ -60,35 +61,12 @@ To clean up all build artefacts and dependencies in workspaces in the repository
 corepack pnpm deep-clean
 ```
 
-## Run local version of Smoldot Extension
-Running the following command will build all necessary dependencies and run the Smoldot Extension in development mode with hot reloading enabled. Once run a new (Chrome) browser will appear with the extension added.
-
-```bash
-corepack pnpm dev:extension
-```
-
-(Make sure to run `$ pnpm install` before.)
-
-## Run local version of Burnr wallet
-Running the following command will build all necessary dependencies and run the Substrate Burnr Wallet in development mode with hot reloading enabled. It will be served on http://localhost:1234/
-
-```bash
-corepack pnpm dev:burnr
-```
-
-(Make sure to run `$ pnpm install` before.)
-
-
-## [Deployments and releases](./DEPLOY-RELEASE.md)
-
-
-## Substrate Connect Extension
+## Releasing
 
-A Browser extension that keeps the latest state of well known substrate-based chains' specs and bootnodes (Polkadot, Kusama, Rococo, Westend) synced across tabs - using Substrate Connect and Smoldot light client; 
+Visit [the release doc](./DEPLOY-RELEASE.md) and follow the steps there to release a new version of the extension.
 
-The Extension is using Substrate Connect and Smoldot light client node modules. This extension, upon browser initiation updates and synchronizes in the well known substrate chain specs (Polkadot, Kusama, Rococo, Westend), keeping them to the latest state inside the extension, for faster chain sync. When a dApp that supports Substrate Connect (e.g. polkadotJS apps) starts in a browser's tab, then it receives the latest specs from the Extension instead of wrap-syncing from the last imported inside the dApp; At the same time, the dApp will appear inside the Extension as "connected" - meaning that it is using the Extension's bootnodes and specs;
+## Useful Links
 
-## Useful Links:
 [Substrate Connect Documentation Page](https://substrate.io/developers/substrate-connect/)
 
 Download at: