updated docs, readme & change log