extended the readme. still needs some more work, but should be very
useful already as it is.