Updated docs based on Patricks PR comments.