improved documentation more and fixes some minor issues noticed while updating documentation