I love people who think everything has to be aimed for their consumption.
Some things are aimed at a group of people, and written with that in mind. Someone closing a project/stopping maintenance of something, usually write directly to the group of users of the software.
To expect everything to contain information about everything someone could not know, means everything would have to be extremely verbose. We have search engines, typing "4coder" and finding the website took me around 2 seconds, I'm sure you'd be able to do it just as fast.
> The individual posting the article may not be the owner of the code base
Good point, I didn't consider that.
The point of view I'm coming from is that while it's impossible to put all possible information in a README (and such level of detail would probably make it even less readable, like Whitehead and Russel's Principia Mathematica) - there are some things that are reasonable to expect on any kind of public repository (I assume it's a public repository because of the README's public-facing style - "Welcome to the 4coder code base. [...] In this readme you will find: [...]"), such as "what is the purpose of this program".
I know nobody owes anything to nobody, and such criticism might be seen as rude - since we're basically criticizing volunteers - but consider the fact that feedback is a major part of how we figure out our mistakes. If someone is posting their work online, it would be reasonable to assume that they care about their work and want to make it better. Without (constructive) criticism, they would never receive the feedback required for improving. Praise is pleasant and should be given when it's due, but criticism is also useful information.
Well, anyone can post a link to HN but only the project author can adjust the project’s README. Perhaps a better URL exists, but also perhaps not everything on HN has to be for everyone on HN. This is obviously news for people who know what 4Coder is, not necessarily meant to onboard people who don’t want to look up what 4Coder is.
> I love people who think everything has to be aimed for their consumption.
I love how people don't bother providing information that would be easy to provide, the URL to the website would be handy as here it isn't even included in the README on github, then people get all het up when others mention the lack of information.
I love people who think that they have any semblance of an idea of who will see or read their stuff. It's so pre-Gutenberg of them. ;)
You don't have to write your things FOR EVERYONE but it isn't unreasonable to suggest that folks are going to link to random projects on github and that other folks may end up on said project through unexpected means, and with no context, or with unexpected context. It probably follows that that _maybe_ spending the time to write _one sentence_ to describe WTF you're looking if you want ANYONE to consume it isn't unreasonable.
