Update readme

Author: acolytec3

README.md

@@ -19,8 +19,9 @@ in [test-gen][test-gen]
 The specification itself is written in [OpenRPC][openrpc]. Refer to the OpenRPC
 specification and the JSON schema [specification][json-schema] to get started.
 
-### Building
+### Updating the specs
 
+#### Compiling
 The specification is split into multiple files to improve readability. The
 spec can be compiled into a single document as follows:
 
@@ -33,11 +34,26 @@ Build successful.
 This will output the file `openrpc.json` in the root of the project. This file
 will have all schema `#ref`s resolved.
 
-#### Testing
+#### Building the docs
+
+Once you've updated something in the spec, you can use the docs generation tools
+to view the updated specs locally.  
+
+```console
+$ npm run build:docs
+$ npm run watch
+```
+
+The `watch` command starts a local webserver serving the docs in-browser at 
+`http://0.0.0.0:8000` and it rebuilds when you update something in the specs.  
+Please reload the page to see your changes.
+
+### Testing
 
 There are several mechanisms for testing specification contributions and client
 conformance.
 
+#### Linting
 First is the [OpenRPC validator][validator]. It performs some basic syntactic
 checks on the generated specification.
 
@@ -47,13 +63,21 @@ $ npm run lint
 OpenRPC spec validated successfully.
 ```
 
+#### Spec tests
 Next is `speccheck`. This tool validates the test cases in the `tests`
-directory against the specification.
+directory against the specification.  There are two npm scripts to simplify this.
+
+```console
+$ npm run build:test
+$ npm run test 
+all passing.
+```
+
+or
 
 ```console
 $ go install github.com/lightclient/rpctestgen/cmd/speccheck@latest
 $ speccheck -v
-all passing.
 ```
 
 If you get an error that says: `speccheck: command not found`,
@@ -63,6 +87,8 @@ If you get an error that says: `speccheck: command not found`,
 $ export PATH=$HOME/go/bin:$PATH
 ```
 
+#### Spelling
+
 The spell checker ensures the specification is free of spelling errors.
 
 ```console
@@ -75,8 +101,9 @@ pyspelling is a wrapper around either [Aspell](http://aspell.net/) or
 [Hunspell](https://hunspell.github.io/). You'll need to install
 one of those before running `pyspelling`.
 
+#### Hive tests
 Finally, the test cases in the `tests/` directory may be run against individual
-execution client using the [`hive`] simulator [`rpc-compat`][rpc-compat].
+execution client using the [`hive`][hive] simulator [`rpc-compat`][rpc-compat].
 Please see the documentation in the aforementioned repositories for more
 information.