Comment by IshKebab
I would recommend not having an AI write your README. Even if you didn't use AI for coding at all and the code works perfectly, it really doesn't inspire confidence.
I would recommend not having an AI write your README. Even if you didn't use AI for coding at all and the code works perfectly, it really doesn't inspire confidence.
Makes me sad because I used to put a lot of effort into my readmes. Not insane amount of emojis but some and actually useful badges but not overkill. But in the end they always had nicely structured layouts etc..
I feel like I have to make mine sloppier now to pass the AI smell test
The commit names look very weird too, feel more like marketing speak:
> BREAKTHROUGH: Fix critical ID mismatch in Cap'n Web protocol
> TIER 3 ULTIMATE: Extreme Stress Tests & Advanced Capability Composition
> Achieve Cap'n Web protocol mastery with perfect capability composition (note: this exact commit name is repeated another time)
The commit descriptions are even worse. If they’re so blatantly not written for anyone to read, why bother generating them at all?
OP here. :-) (feel like I should put an emoji here). My focus as I "built" this was getting to a correct implementation, and putting in place guards and context to achieve that. As I moved through the process I added more and more ways to eval progress toward that. An area I didn't invest any of my effort in was commit messages, and some of them caused me to spit take as I saw them go by. I think this is something that can definitely be improved, and this conversation is fuel for thought on how to do this.
Yeah, LLM-created commit messages verge on "Brilliant Paula" for some reason. It's probably because nobody bothers to RLHF commit messages (yet).
Well, most of commits have „brianathere and claude” as authors. Additionally, the style of comments in some of the files bears a strong resemblance to those typically generated by LLMs.
Moreover, this whole thing has 7 stars on GitHub as of writing, and yet the bottom of README boldly claims „ready for production use”. For me, that overly confident approach discourages maybe even more.