adding UML class diagram, some general notes, design doc