add some preliminary design documentation