add troubleshooting section
log all changes