New node doc (#847)

* initial new node edits

Signed-off-by: Eric Lin <[email protected]>

* updated markdown links to work properly

Signed-off-by: Eric Lin <[email protected]>

* fix api markdown link to link to subsection

Signed-off-by: Eric Lin <[email protected]>

* small fixes

Signed-off-by: Eric Lin <[email protected]>

* pass markdownlint and vale tests

Signed-off-by: Eric Lin <[email protected]>

* fix indentation

Signed-off-by: Eric Lin <[email protected]>

* Made minor edits.

Signed-off-by: bgravenorst <[email protected]>

* Address minor comment.

Signed-off-by: bgravenorst <[email protected]>

Co-authored-by: bgravenorst <[email protected]>

docs/Tutorials/Developer-Quickstart.md

@@ -14,6 +14,7 @@ description: Rapidly generate local blockchain networks.
     - Docker desktop configured to use the WSL2-based engine
 
 !!! important
+
     Ensure you allow Docker up to 4G of memory or 6G if running the privacy examples.
     Refer to the _Resources_ section in [Docker for Mac](https://docs.docker.com/docker-for-mac/) and
     [Docker Desktop](https://docs.docker.com/docker-for-windows/) for details.
@@ -84,3 +85,115 @@ the tutorial.
 
 Follow the [dapp walk-through](Examples/Private-Network-Example.md#smart-contract-and-dapp-usage) which details
 how to deploy the dapp and interact with the network.
+
+## Add a new node to the network
+
+New nodes joining an existing network require the following:
+
+- The same genesis file used by all other nodes on the running network.
+- A list of nodes to connect to; this is done by specifying [bootnodes], or by providing a list of [static nodes].
+- A node key pair and optionally an account. If the running network is using permissions, then you need
+  to add the new node's enode details to the [permissions file] used by existing nodes, or update
+  the onchain permissioning contract.
+
+The following steps describe the process to add a new node to the Developer Quickstart.
+
+### 1. Create the node key files
+
+Create a node key pair and account for a new node by running the following script:
+
+```bash
+cd ./extra
+npm install
+node generate_node_keys.js --password "Password"
+```
+
+!!! note
+
+    The `--password` parameter is optional.
+
+### 2. Create new node directory
+
+Navigate to the directory where the configuration files for the network were created.
+
+!!! note
+
+    The directory was specified in an earlier step when running `npx quorum-dev-quickstart`. The default
+    location is `./quorum-test-network`.
+
+In the `config/nodes` directory, create a subdirectory for the new node (for example, `newnode`), and move the
+`nodekey`, `nodekey.pub`, `address` and `accountkey` files from the previous step into this directory.
+
+### 3. Update docker-compose
+
+Add an entry for the new node into the docker-compose file:
+
+```yaml
+  newnode:
+    <<: *besu-def
+    container_name: newnode
+    volumes:
+      - public-keys:/opt/besu/public-keys/
+      - ./config/besu/:/config
+      - ./config/nodes/newnode:/opt/besu/keys
+      - ./logs/besu:/tmp/besu
+    depends_on:
+      - validator1
+    networks:
+      quorum-dev-quickstart:
+        ipv4_address: 172.16.239.41
+```
+
+!!! important
+
+    Select an IP address and port map not being used for the other containers. Additionally mount the newly created
+    folder `./config/nodes/newnode` to the `/opt/besu/keys` directory of the new node, as seen in the example above.
+
+### 4. Update Prometheus configuration
+
+Update `prometheus.yml` in the `./config/prometheus/` directory to configure metrics to display in Grafana.
+
+Insert the following under `scrape_configs` section in the file. Ensure you change `job_name` and `targets`
+appropriately if you've updated them.
+
+```yaml
+- job_name: newnode
+  scrape_interval: 15s
+  scrape_timeout: 10s
+  metrics_path: /metrics
+  scheme: http
+  static_configs:
+    - targets: [newnode:9545]
+```
+
+### 5. Update files with the enode address
+
+Add the new node's enode address to the [static nodes] file and [permissions file].
+The enode uses the format `enode://pubkey@ip_address:30303`.
+If the `nodekey.pub` is `4540ea...9c1d78` and the IP address is `172.16.239.41`, then the enode
+address would be `"enode://[email protected]:30303"`,
+which must be added to both files.
+
+Alternatively, call the
+[`perm_addNodesToAllowlist`](https://besu.hyperledger.org/en/latest/Reference/API-Methods/#perm_addnodestoallowlist)
+API method on existing nodes to add the new node without requiring a restart.
+
+!!! note
+
+    Please note that calling the API method by itself will only persist for as long as the nodes remain online
+    and will be lost on next restart.
+
+    On a live network, the new node must be added to the [permissions file] so that subsequent restarts
+    of the nodes are aware of the change.
+
+### 6. Start the network
+
+Once complete, start the network up with `./run.sh`.
+When using the smart contract you can either make changes via a [dapp](https://github.com/ConsenSys/permissioning-smart-contracts) or via RPC
+[API] calls.
+
+[api]: ../Reference/API-Methods.md#perm_addNodesToAllowlist
+[bootnodes]: ../HowTo/Deploy/Bootnodes.md
+[permissions file]: ../HowTo/Limit-Access/Local-Permissioning.md
+[static nodes]: ../HowTo/Find-and-Connect/Static-Nodes.md
+[allow list]: ../HowTo/Limit-Access/Local-Permissioning.md#node-allowlisting