README: a bit more documentation and examples