make changes based on reviews

please add a link to the glossary for an explanation of what a workflow is.