diff --git a/substrate/README.adoc b/substrate/README.adoc
index 0b0670a8c0c0cc17c9ddf16017d9c00f8f3dc334..01d4788705c86adb17503486532260d07693fa7f 100644
--- a/substrate/README.adoc
+++ b/substrate/README.adoc
@@ -129,9 +129,18 @@ rustup update nightly
 rustup target add wasm32-unknown-unknown --toolchain nightly
 rustup update stable
 cargo install --git https://github.com/alexcrichton/wasm-gc
-sudo apt install cmake pkg-config libssl-dev git
 ----
 
+You will also need to install the following packages:
+
+ - Linux:
+[source, shell]
+sudo apt install cmake pkg-config libssl-dev git
+
+ - Mac:
+[source, shell]
+brew install cmake pkg-config openssl git
+
 Then, grab the Substrate source code:
 
 [source, shell]
@@ -158,6 +167,10 @@ You can start a development chain with:
 [source, shell]
 cargo run -- --dev
 
+Or you can join the BBQ Birch Testnet with:
+[source, shell]
+cargo run
+
 include::doc/packages/packages.adoc[]
 
 include::CONTRIBUTING.adoc[leveloffset=+1]