Improve the README intro

Make clear what this mode does, and what it needs.
Document all features in commentary
Reference Flycheck for on-the-fly liniting