improve documentation, formatting