Hacker News Reader

Nice work! I especially appreciated the emphasis on writing a good README… but I think it's missing the most crucial thing you need on top your README. That's the motivation aka why the project exists at all, why it's better than the alternatives, etc.

View on HN

The differentiating qualities of the project is indeed very important. But I think it's more than okay to also say that "this is a clone of xxx I'm using to learn yyy".

Putting a bit more into the README has my preference. Often I come acros repos with “I cloned xxx with yyy”, where I have never heard of xxx. It only takes a bit more to briefly explain xxx.

Reply on news.ycombinator.com