Update README

Re-write the documentation, on the off-chance that this module proves useful to
people outside the WMF.

Change-Id: I9b3297f540154b1d08f1d4be3324a4a08bb84c25