more general work on the design document