Fixed make docs target
Moved complete example to be within sphinx source
Removed duplicated information from readme and pointed to new documentation
Fix readme typos.