diff --git a/development.md b/development.md
index 8a3c4d6b..cd390502 100644
--- a/development.md
+++ b/development.md
@@ -2,12 +2,18 @@
 
 ## Test suite
 
+Run this from the project root directory. It will make sure each site type builds. It first does an sdist, which ensures we are testing what will be put on hackage.
+
   shelltest tests/scaffold.shelltest
 
-## Automated builder
+## Quicker, repeatable site building
+
+Useful for debugging individual failures.
 
   tests/runscaffold.sh < sqlite-input.txt
 
 ## Getting a list of scaffold files for the cabal file
 
+It is necessary after adding a scaffolding file to add it to the list of files in the cabal file.
+
   find scaffold -type f
diff --git a/tests/scaffold.shelltest b/tests/scaffold.shelltest
index 31bbf7a9..16cd5be7 100644
--- a/tests/scaffold.shelltest
+++ b/tests/scaffold.shelltest
@@ -1,9 +1,13 @@
-# use shelltest
-# note that the first cabal install line is its own test
-# cabal install shelltestrunner
-# shelltest test.shelltest
+# This uses shelltest
+#
+#   cabal install shelltestrunner
+#   shelltest tests/scaffold.shelltest
+#
+# note that the first 2 lines setup this test but will also be counted as 2 tests.
 
-cabal clean && cabal install
+cabal clean && cabal install && cabal sdist
+
+for f in $(ls -1rt dist/*.tar.gz | tail -1); do tar -xzvf $f && cd `basename $f .tar.gz`; done
 
 rm -rf foobar && runghc scaffold.hs init && cd foobar && cabal install && cabal install -fdevel && cd ..
 <<<