update readme, add a few comments for links/roles