updating documentation to use new glosary