add some design notes