rewriting the design notes and tweaking a UML file