added descriptions of diagrams