updates design notes and diagrams