If, when and how should I use SwissSchema?

[joeljuca]

This module implements functionality that's similar to what some object-oriented frameworks do: it puts the data schema definition and the data manipulation functions together. It doesn't tie data to functions, but it contrasts with the Phoenix culture of using context modules to provide external-facing data manipulation functions. This difference might bring confusion to developers wondering if, how, and when they should use this library.

So, covering these questions/wonderings right in the README.md might just make sure users are properly educated about the goods and bads of this approach.

An entry in FAQ.md should be added to cover this questions.

[joeljuca]

We have a FAQ.md now, so it's better to just move this content to it and link it in the README.md.