updated docs and format based off feedback