This looks like it'd be better kept in an issue tracker. :) I created http://tickets.musicbrainz.org/browse/PW just now, so go ahead and create bugs/tasks/improvements/etc. there as necessary. Then we can come up with a proper README.