ref doc updates, fixing typos