updated documentation with troubleshooting section