diff --git a/docs/build-smart-contracts.md b/docs/build-smart-contracts.md
index a5d6aae5db25..9e1e4d693eed 100644
--- a/docs/build-smart-contracts.md
+++ b/docs/build-smart-contracts.md
@@ -8,11 +8,13 @@ The Polkadot relay chain will not support smart contracts natively.  However, pa
 
 ## Resources
 
-Here are the list of current resources available to developer who want to get started writing smart contracts to deploy on parachains based on Substrate.
+Here is the list of current resources available to developers who want to get started writing smart contracts to deploy on parachains based on Substrate.
+
+- [ink!](https://github.com/paritytech/ink) - Parity's ink! eDSL to write smart contracts.
+- [Deploying your first contract](https://github.com/paritytech/ink/wiki/Deploying-Your-First-Contract) - Guide to deploy the provided `flipper` contract.
+- [Writing your first contract](https://github.com/paritytech/ink/wiki/Writing-Your-First-Contract) - Guide to how one would write the `flipper` contract.
+- [Substrate contracts workshop](https://shawntabrizi.github.io/substrate-contracts-workshop/#/) - Walks you through the basics of using `ink!` and writing an ERC20 token.
 
-- [ink!](https://github.com/paritytech/ink) - Parity's ink to write smart contracts.
-- [Substrate Contracts Workshop](https://substrate.dev/substrate-contracts-workshop/#/) - Walks you through the basics
-  of writing and deploying an ERC20 token using `ink!`.
 
 ## Examples