add design notes; markdown that bitch