update notes and add troubleshooting guide