improve diagnostics in README (fixes #304)