made changes mostly to documentation, troubleshooting resolution weirdnesses