add troubleshooting section and extended usage docs