final readme updates and build check