update readme and descriptions snippets