Documentation updates

The troubleshooting section now includes more possible causes and
solutions to programming failures, and the description of the flaky
segment problem is more detailed, mentioning some of the rarer
symptoms people have reported on the Adafruit forums.