add documentation on common troubleshooting problems