2 files changed, 12 insertions, 5 deletions
diff --git a/doc/INSTALL.md b/doc/INSTALL.md
index 325ccfbdd..b71b89676 100644
--- a/doc/INSTALL.md
+++ b/doc/INSTALL.md
@@ -318,6 +318,9 @@ like `!!(*= $this *)!!`.  The variables are:
 * `user`: the user that the software runs as
 * `site`: a string to identify your alaveteli instance
 
+There is a dumb python script at `script/make-crontab` which you can
+edit and run to do some basic substitution for you.
+
 One of the cron jobs refers to a script at
 `/etc/init.d/foi-alert-tracks`.  This is an init script, a copy of
 which lives in `config/alert-tracks-debian.ugly`.  As with the cron
diff --git a/doc/THEMES.md b/doc/THEMES.md
index 50335c082..e33371df7 100644
--- a/doc/THEMES.md
+++ b/doc/THEMES.md
@@ -36,13 +36,17 @@ places:
 
 This document is about what you can do in a theme.
 
-To get started, install the sample theme by running 
+By default, the sample theme ("alavetelitheme") has already been 
+installed.  See the setting `THEME_URLS` in `general.yml` for an 
+explanation.
+
+You can also install the sample theme by hand, by running:
 
     ./script/plugin install git://github.com/sebbacon/alavetelitheme.git
     
-This downloads and installs the theme in
-`vendor/plugins/alavetelitheme` and contains examples for nearly
-everything you might want to customise.
+The sample theme contains examples for nearly everything you might 
+want to customise.  You should probably make a copy, rename it, and
+use that as the basis for your own theme.
 
 # Make sure your theme is as lightweight as possible
 
@@ -81,7 +85,7 @@ instead of the core "about us" file.
 Rails expects all its stylesheets to live at `<railshome>/public`,
 which presents a problem for plugins.  Here's how we solve it: the
 stylesheet and associated resources for your theme live (by
-convention) in at `alavetelitheme/public/`.  This is symlinked from
+convention) in `alavetelitheme/public/`.  This is symlinked from
 the main Rails app -- see `alavetelitheme/install.rb` to see how this
 happens.