Refactor documentation to be more independent and catchy

[arnfaldur]

The API reference includes a large amount of comparison to Ramda, especially in the beginning.

Most of it is not relevant to users discovering the project.
I suggest moving the detailed comparison to a dedicated section that can be linked to in the beginning for potential Ramda converts.

I also think the README.md could sell the library better. Making the first few paragraphs of the README.md snazzier could be an improvement.

I can do this if there is interest.