final edits to documentation
manually update references