add diagrams to aid the docs