diff --git a/README.md b/README.md
index 4529326b43f8b240b6033ece2d402e2de6f465d3..5b5edd988d9dbfe7bbd35dad5562d44843c30ce3 100644
--- a/README.md
+++ b/README.md
@@ -12,10 +12,11 @@ This repo is an R package. This means:
  * package functions are kept in /R
  * help files auto-created by roxygen are in /man
  * if you clone it you can build it and use the functions
- * drake::rmake(source = "_drake_XX.R") is run from inside a make_XX.R file
- * the drake plan is kept inside _drake_XX.R along with the functions and package loading. This is not quite what the drake book recommends but it works for us
- * Rmd scripts called by the drake plan in _drake_XX.R and used for reporting the results of drake plans are in /Rmd
- * outputs are kept in /docs (reports, plots etc)
+ * we use drake like this:
+     * drake::r_make(source = "_drake_XX.R") is run from inside a make_XX.R file
+     * the drake plan is kept inside _drake_XX.R along with the functions and package loading. This is not quite what the drake book recommends but it works for us
+     * Rmd scripts called by the drake plan that is specified in _drake_XX.R and used for reporting the results of drake plans are kept in /Rmd
+     * outputs are kept in /docs (reports, plots etc)
  * you (and we) keep your data out of it!
 
 We'd love your contributions - feel free to: