PROJ-56: adding specification md and pictures
PROJ-56: better formulation in comment
PROJ-56: refactoring. Moving uml files