diff --git a/README.md b/README.md
index 85e98c8..6b1d9a9 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,9 @@
 # repo2docker-r
-JupyterHub-based repo2docker template for R
+
+JupyterHub-based repo2docker template for R.  
+
+- Edit `install.r` to install your R packages.
+- Edit `environment.yml` to install Python packages.
+
+Provides JupyterHub with RStudio integration.  `install.r` uses `r2u` mechanism to automatically install any necessary system dependencies. `apt-get` is not necessary.
+