added a couple of design notes