updating with diagram and some text