readme: add a more robust readme with examples