Made several small improvements mainly in the comments, readme and examples