Updated readme [ci skip]

Improved wording of intro, clearer code examples, credit section.