updates to write-up