tidy up of docs and moved test to examples