Improved facade docs
Merge pull request #203 from GrahamCampbell/docs

Improved facade docs