updates for the troubleshooting doc