readme updates and some utils