updatd design documentation and todos