[docs] more docs and some simple bug fixes