some docs + tidy up