added some design notes