docs(*): address doc feedback