update readme, fixes #1

describe of content and fixes