some diagram updates
documentation & license