docs(*): typos, clarification, remove old docs