diff --git a/README.rst b/README.rst
index 76f4ad55d..6c87201c4 100644
--- a/README.rst
+++ b/README.rst
@@ -68,10 +68,10 @@ Windows users
 ~~~~~~~~~~~~~
 
 If you're on Windows Vista or higher, be sure that the "Symbolic Links"
-option was selected when installing Git prior to cloning this repository. If 
-you're still seeing errors about files not being found it is likely because 
-the symlink at ``api/client-server/definitions/event-schemas`` looks like a 
-file. To correct the problem, open an Administrative/Elevated shell in your 
+option was selected when installing Git prior to cloning this repository. If
+you're still seeing errors about files not being found it is likely because
+the symlink at ``api/client-server/definitions/event-schemas`` looks like a
+file. To correct the problem, open an Administrative/Elevated shell in your
 cloned matrix-doc directory and run the following::
 
   cd api\client-server\definitions
@@ -121,7 +121,7 @@ changes.
 It is written in Go, so you will need the ``go`` compiler installed on your
 computer. You will also need to install fsnotify by running::
 
-  go get gopkg.in/fsnotify.v1
+  go get gopkg.in/fsnotify/fsnotify.v1
 
 Then, create a virtualenv as described above under `Preparation`_,
 and::
diff --git a/scripts/continuserv/README b/scripts/continuserv/README
deleted file mode 100644
index edb9aef4e..000000000
--- a/scripts/continuserv/README
+++ /dev/null
@@ -1,6 +0,0 @@
-continuserv proactively re-generates the spec on filesystem changes, and serves it over HTTP.
-
-To run it, you must install the `go` tool. You will also need to install fsnotify by running:
- `go get gopkg.in/fsnotify/fsnotify.v1`
-You can then run continuserv by running:
- `go run main.go`
diff --git a/scripts/continuserv/README.md b/scripts/continuserv/README.md
new file mode 100644
index 000000000..40321bb62
--- /dev/null
+++ b/scripts/continuserv/README.md
@@ -0,0 +1,3 @@
+continuserv proactively re-generates the spec on filesystem changes, and serves
+it over HTTP. For notes on using it, see [the main
+readme](../../README.rst#continuserv).