Docs fixes and additions

Fix docs - that was my last task. I hope this will have some favour. Waiting for comments.