filling out the design notes more