Documentation Fixes

[theadam]

The documentation reads a little funky. The last few sections need some updates. Maybe an approach that includes more examples would be better.

[SandroMachado]

I believe that some of the example are also outdated. I will try to fix this ASAP.

[SandroMachado]

I introduced the installation instructions to Carthage and CocoaPods. I also fixed the basic example.