design docs update