updated design-notes