Documentation updates

The main README now better describes the firmware and hardware
branches of this project and is better tailored to the majority of
xmas users who run the xmas firmware on the Adafruit clock (v1.1).