some more docs and readability fixes