Quickstart guide + updates

docs/the_nimbus_book/src/SUMMARY.md

@@ -2,10 +2,10 @@
 - [Introduction](./intro.md)
 - [Philosophy]()
 - [System requirements](./hardware.md)
-- [Quick start]()
+- [Run just the beacon node (quickstart)](./quick-start.md)
 
 # Raspberry Pi
-- [Run your node on a Raspberry Pi](./pi-guide.md)
+- [Validating with a Raspberry Pi](./pi-guide.md)
 - [Mainnet advice](./pi-guide-mainnet.md)
 
 # How-to
@@ -13,8 +13,8 @@
 - [Build the beacon node](./build.md)
 - [Run an eth1 node](./eth1.md)
 - [Sync the beacon node](./start-syncing.md)
-- [Make a deposit](./deposit.md)
-- [Import your keys](./keys.md)
+- [Make a deposit for your validator](./deposit.md)
+- [Import your validator keys](./keys.md)
 - [Connect your validator to eth2](./connect-eth2.md)
 - [Keep an eye on your validator](./keep-an-eye.md)
 - [Keep Nimbus updated](./keep-updated.md)

docs/the_nimbus_book/src/deposit.md

@@ -1,4 +1,4 @@
-# Make a deposit
+# Make a deposit for your validator
 The easiest way to get your deposit in is to follow the Ethereum Foundation's launchpad instructions here:
 
 **Testnet**:

docs/the_nimbus_book/src/install.md

@@ -46,6 +46,63 @@ Assuming you use [Homebrew](https://brew.sh/) to manage packages
 ```sh
 brew install cmake
 ```
+# Quick start
+
+This page takes you through how to run just the beacon node without a validator attached.
+
+Running just a beacon node can help improve the anonymity properties of the network as a whole.
+
+### 1. Install dependencies
+
+You'll need to install some packages (`git`) in order for Nimbus to run correctly.
+
+To do so, run:
+```
+sudo apt-get install git
+
+```
+
+### 2. Clone the Nimbus repository
+
+Run the following command to clone the [nimbus-eth2 repository](https://github.com/status-im/nimbus-eth2):
+
+```
+git clone https://github.com/status-im/nimbus-eth2
+```
+
+### 3. Build the beacon node
+
+Change into the directory and build the beacon node.
+```
+cd nimbus-eth2
+make nimbus_beacon_node
+```
+
+*Patience... this may take a few minutes.*
+
+### 4. Connect to mainnet
+
+To connect to mainnet, run:
+```
+./run-mainnet-beacon-node.sh
+```
+
+You'll be prompted to enter a web3-provider url:
+
+```
+To monitor the Eth1 validator deposit contract, you'll need to pair
+the Nimbus beacon node with a Web3 provider capable of serving Eth1
+event logs. This could be a locally running Eth1 client such as Geth
+or a cloud service such as Infura. For more information please see
+our setup guide:
+
+https://status-im.github.io/nimbus-eth2/eth1.html
+
+Please enter a Web3 provider URL:
+```
+
+Press enter to skip (this is only important when you're running a validator).
+
 
 ### Windows
 

docs/the_nimbus_book/src/keys.md

@@ -1,4 +1,4 @@
-# Import your keys
+# Import your validator keys
 
 To import your signing key(s) into Nimbus, copy the `validator_keys` directory -- the directory that was created for you when you generated your keys -- into `nimbus-eth2`. Then run:
 

docs/the_nimbus_book/src/quick-start.md

@@ -0,0 +1,76 @@
+# Run just the beacon node (quickstart)
+
+This page takes you through how to run just the beacon node without a validator attached.
+
+Running a beacon node without a validator attached can help improve the anonymity properties of the network as a whole.
+
+## 1. Install dependencies
+
+You'll need to install some packages in order for Nimbus to run correctly.
+
+
+**Linux**
+
+On common Linux distributions the dependencies can be installed with
+
+```sh
+# Debian and Ubuntu
+sudo apt-get install build-essential git
+
+# Fedora
+dnf install @development-tools
+
+# Archlinux, using an AUR manager
+yourAURmanager -S base-devel
+```
+
+**macOS**
+
+Assuming you use [Homebrew](https://brew.sh/) to manage packages:
+
+```sh
+brew install cmake
+```
+
+
+## 2. Clone the Nimbus repository
+
+Run the following command to clone the [nimbus-eth2 repository](https://github.com/status-im/nimbus-eth2):
+
+```
+git clone https://github.com/status-im/nimbus-eth2
+```
+
+## 3. Build the beacon node
+
+Change into the directory and build the beacon node.
+```
+cd nimbus-eth2
+make nimbus_beacon_node
+```
+
+*Patience... this may take a few minutes.*
+
+## 4. Connect to mainnet
+
+To connect to mainnet, run:
+```
+./run-mainnet-beacon-node.sh
+```
+
+You'll be prompted to enter a web3-provider url:
+
+```
+To monitor the Eth1 validator deposit contract, you'll need to pair
+the Nimbus beacon node with a Web3 provider capable of serving Eth1
+event logs. This could be a locally running Eth1 client such as Geth
+or a cloud service such as Infura. For more information please see
+our setup guide:
+
+https://status-im.github.io/nimbus-eth2/eth1.html
+
+Please enter a Web3 provider URL:
+```
+
+Press enter to skip (this is only important when you're running a validator).
+