add example README; improve examples