updated diagram and related text