smoketest: Better handling of site configuration, improved documentation

Sitedefs should be shipped as a sample and copied and held as an unversioned sitedefs.py on each site.
Added a Readme which explains how to use the tests suite.