docs: add the troubleshooting section
and move some questions from the faq into it