dome readme goodness
readme explaining api
not propagating sync errors