#8 Add documentation for the website

* also heavily revised README