more edits to design and documentation