updates README; improve documentation