added docs for public stuff