docs(1387): act on the README review — fairness, wrong counts, buried lede (#1388)