adding description and diagrams