better doco

fixes #7
refs