Not even Linux, the READMEs of a lot of code repositories are sometimes made for people who already know what it is, but seem alien to anyone just trying to understand “does this codebase help with my use-case?”
My experience is the opposite. Open a project’s website, it’s full of marketing talk where I can’t find what the project does in a minute or several minutes. Open Github instead, the readme starts with “this thing is for doing X with Y under Z circumstances”. These days I mostly skip sites and go straight to Github.
Not even Linux, the READMEs of a lot of code repositories are sometimes made for people who already know what it is, but seem alien to anyone just trying to understand “does this codebase help with my use-case?”
My experience is the opposite. Open a project’s website, it’s full of marketing talk where I can’t find what the project does in a minute or several minutes. Open Github instead, the readme starts with “this thing is for doing X with Y under Z circumstances”. These days I mostly skip sites and go straight to Github.
Maybe you need the sites instead, idk.