updates to diagrams and glossary