some design notes