updated user spec
merged README