diff --git a/site-cookbooks/kosmos-parity/README.md b/site-cookbooks/kosmos-parity/README.md
index 7357580..a304316 100644
--- a/site-cookbooks/kosmos-parity/README.md
+++ b/site-cookbooks/kosmos-parity/README.md
@@ -35,16 +35,15 @@ This cookbook installs [Parity](https://parity.io/) nodes
 
 ### kosmos-parity::default
 
-Just include `kosmos-parity` in your node's `run_list`:
+### kosmos-parity::node_dev
 
-```json
-{
-  "name":"my_node",
-  "run_list": [
-    "recipe[kosmos-parity]"
-  ]
-}
-```
+Sets up a parity node running on the dev chain on port 8545 (behind nginx, with
+HTTPS)
+
+### kosmos-parity::node_testnet
+
+Sets up a parity node running on the testnet chain on port 8546 (behind nginx,
+with HTTPS)
 
 ## License and Authors
 
diff --git a/site-cookbooks/kosmos-parity/recipes/node_dev.rb b/site-cookbooks/kosmos-parity/recipes/node_dev.rb
index b15bea3..7c2bd51 100644
--- a/site-cookbooks/kosmos-parity/recipes/node_dev.rb
+++ b/site-cookbooks/kosmos-parity/recipes/node_dev.rb
@@ -7,6 +7,9 @@
 # All rights reserved - Do Not Redistribute
 #
 
+# Sets up a parity node running on the dev chain on port 8545 (behind nginx,
+# with HTTPS)
+
 rpc_proxy_port = 8545
 rpc_port       = 18545
 
diff --git a/site-cookbooks/kosmos-parity/recipes/node_testnet.rb b/site-cookbooks/kosmos-parity/recipes/node_testnet.rb
index 145ab53..2bac0a8 100644
--- a/site-cookbooks/kosmos-parity/recipes/node_testnet.rb
+++ b/site-cookbooks/kosmos-parity/recipes/node_testnet.rb
@@ -7,6 +7,9 @@
 # All rights reserved - Do Not Redistribute
 #
 
+# Sets up a parity node running on the testnet chain on port 8546 (behind
+# nginx, with HTTPS)
+
 rpc_proxy_port = 8546
 rpc_port       = 18546