improved docs some more