final layout and readme updates