making some documentation more consistent, adding content to the README