Updated the augeas README

I intentionally left the explanation of the error case because I think it helps to understand what happens behind the curtains.