docs & readme updates