renewed diagram
sync docs with diagram