Improve the documentation

[f3ath]

• Provide more usage examples (see https://github.com/json-api-php/json-api/tree/master/test)
• Split it into several pages
• Get a fancier design (with jekyll?)