updated design and notes