diff --git a/doc/FAQ.md b/doc/FAQ.md
index 4dfb79db..b37bc9e8 100644
--- a/doc/FAQ.md
+++ b/doc/FAQ.md
@@ -33,6 +33,9 @@ grin in case of trouble.
 ## Build error: Could not compile `tokio-retry`.
 You need the latest rust. rustup, or [reinstall rust as described](build.md)
 
+## Build error: `failed to select a version for 'serde_json'`
+Run `cargo update? to fix this
+
 # Short term plans
 ## Transaction types
 - (DONE) A temporary simple transaction exchange. Temporary - will be deprecated.
diff --git a/doc/build.md b/doc/build.md
index 6eb77a3f..dbe423cd 100644
--- a/doc/build.md
+++ b/doc/build.md
@@ -41,6 +41,8 @@ cd grin
 git checkout milestone/testnet1
 cargo build
 ```
+## Build errors
+See [Troubleshooting](faq.md#troubleshooting)
 
 #### Cross-compiling
 
@@ -167,4 +169,3 @@ See [wallet](wallet.md) for more info on the various Grin wallet commands and op
 For further information on a more complicated internal setup for testing, see the [local net documentation](local_net.md)
 
 The [grin.toml](../grin.toml) configuration file has further information about the various options available.
-