slop README. If you couldn't be bothered to write it, don't expect people to read it.
Slop is excessively redundant. Basically "purple prose" of the technical documentation.
But primarily: if its not worth writing, its not worth reading.
(I use Claude to prepare half of my technical documentation but then i review EVERY single file. And every single one gets extensively edited despite being coherent from the outset. I just feel like it would be disrespectful to get LLM spit something out and ask my colleagues to read it. Like.... come on.)
Also “README is for humans” might have been true awhile ago, these days README’s are being tailored to Agent as they write most of the code, not humans
Sharing unedited documentation like this is sloppy and speaks for itself ("I can't be bothered to control it"). Leaving readme only to agents is no class, since an alternative is one line of reference to the complete documentation for bots - no need to hijack the repo's first document designation with _that_.
That said my own views on what is/isnt slop is evolving i understand your pov