The HN discussion mentioned in the post is probably this¹, which has a number of useful comments on what other HN users think a README should be(fewer are contradictory than I expected).

¹ https://news.ycombinator.com/item?id=26842191