diff --git a/code/README.md b/code/README.md
index 8858642dffac060bbbd87cfa31c9690f37b20762..b14eb8c49ecd3e74b0f5b18e5882bf20aee6d61e 100644
--- a/code/README.md
+++ b/code/README.md
@@ -1,6 +1,12 @@
 # FPGA Code
 
-Here are the concrete iCEBreaker examples.
+Here are some concrete iCEBreaker examples.
+
+To run them, you'll need the [OSS CAD Suite]https://github.com/YosysHQ/oss-cad-suite-build()
+installed, as well as `make`. And an iCEBreaker dev board.
+
+To synthesize them, change to the relevant directory and run `make`. To program the board, run `make
+prog`.
 
 ## Button Blink