updates to design document, mostly rewording