updated README to fit github page generator better
adding examples