updated docs based off feedback