Documentation updates

The TROUBLESHOOTING section in the firmware README now describes the
flaky segment problem.  Other sections and the main README incorporate
minor edits.