updates to notes and glossary