first pass at design notes