Update README example, the new behaviour of `collection` and a brief description for `index` and `unique`

[ci skip]
Test that `foreign_keys` attributes are listed in attributes hash.