edit readme + cosmetic changes to examples