more docs and small changes