tidied up documentation