docs related improvements