docs: add the troubleshooting section
and move some questions from the faq into it
Merge branch 'pr-1029' into presubmit-stable-pr-1029