readme overhaul, including fix for #15