Lawrence Rosen you are absolutely right. In the short 1.5 years of my journey as a developer, I’ve already got tired of reading all sort of confusing READMEs. It’s less creative, but more productive to standardize them to some degree ;)

In the next side project, I aim to build a linter like CI pipeline for READMEs so that, like with code, we can make incremental improvements to READMEs while preserving the basic structure and best practices.

The prototype is here:

https://github.com/tianhaoz95/readable-readme

for those who are interested.