improve troubleshooting (related to #19)
fix doc