6 ms·
I strongly recommend the authors rewrite the readme by hand. It’s kind of a snif test for how much care someone put into this project.
by khalic 5d ago
I strongly recommend the authors rewrite the readme by hand. It’s kind of a snif test for how much care someone put into this project.
- devinpadron 5d agoAgree. The LLM'isms are offputting.
- VCFundedGenYer 5d agoThrowing my support for this. Do not use LLMs to write things humans should write.
- ravenstine 5d agoReally? I mean, yeah, it's probably written by an LLM, but it's hardly the worst that I've seen. Looks way more straight forward than the modern README featuring a ton of badges, emojis, confusing out-of-context screenshots, "trust me bro" installation instructions, vague elevator pitches, "used by netflix, nasa, disney, good morning america, alex jones, the church of scientology", and other verbiage to create the illusion that the author won't immediately get bored and abandon their glorified dissertation piece. They all scream "give me your github stars" whereas this one doesn't. But I still get what you mean when it comes to the particular 'isms.
- deleted 5d ago[deleted]
- rexpop 5d ago[flagged]
- khalic 5d ago1. Not a tangent, it’s related to the very first content visible on that link. 2. Not a dismissal, an advise from an expert 3. Not complaining, as stated, giving an advise about the optics of using clear LLM prose on the first paragraph
- Barbing 5d agoTangential annoyance?
- conorcleary 4d agoRadial annoyance declarations only!
- 0xbadcafebee 5d agoThis readme is better than most readmes. However they came to making it, it's clearly working
- bityard 5d agoI have the same complaint about oh-my-pi's readme. The tone is obnoxious. It's somehow jaded and matter-of-fact at the same time. Like it was written by that one guy at work who never misses a chance to brag about how clever he is.
- moron4hire 5d agoThere is a band called The Protomen who do rock operas about the Mega Man storyline. They have a very earnest, gritty sound. Every time I read a project README written by AI, I hear the voice over from the first track of the first album, Act 1: Hope Rides Alone (https://youtu.be/VZ8jyGVioxg?is=gsXlgwa4Ubx6LmKE https://youtu.be/VZ8jyGVioxg?is=gsXlgwa4Ubx6LmKE). "Twelve years Light worked and on a cold night in the year 200X, Protoman was born. A perfect man, an unbeatable machine, hell-bent on destroying every evil standing between man and freedom, built for one purpose, to destroy Wily's army of evil robots. Ready. Willing. Prepared to fight." For the Protomen it makes sense. But for a project README it's so absurdly melodramatic.
- xg15 4d agoOne "AI-ism" I noticed is that LLMs often just put sentences behind one another without using any connecting adverbs - and just leave it to the reader's imagination how the sentences are related to each other. E.g. in the readme: "LiteLLM routes LLM calls across providers and translates between message formats. That core is buried under 100k+ LOC of proxy servers, caching layers [etc...]". Those two sentences have opposite sentiment on LiteLLM, so a human author would at least put a "but" between them. In contrast, the LLM just strings them together. This reads "blunt" and "matter-of-fact" at first glance, but I wonder if it's really just an artifact of allocating less space for text generation and more for code in LLMs.
- jatins 4d agoomp is slopware through and through. And it shows, slow as hell to use