fixes of issues found throughout the documentation process