updated docs, add troubleshooting section, add section about update clients