update design notes to reflect the new lay of the land