Add some documentation and examples

[f-f]

I rewrote the README and added some examples. Should fix #3.

In the end I didn't go for an examples folder with all the examples, but embedded them in the README, for consistency with all the other repos around here (also they are much more discoverable).

@arianvp how does it sound?

[arianvp]

LGTM!

Perhaps we should add a comparison to competitors later on. For example, Dhall seems like a way more disciplined alternative to https://github.com/kubernetes/helm

[f-f]

Thanks! I agree with adding a comparison with competitors, I opened an issue to track it.
I used helm just briefly, definitely not enough to write down a comparison. Over here we're not using it because of the complexity (we have a small cluster) and security concerns. For templating so far we've been using Jinja.