new documentation and diagramms