Comment by novocayn

4 days ago

Ohh, I thought that inline comments would make it grokkable and be a low-friction way in. Seems this didn’t land the way I intended :'

Should a multi-part blog would've been better?

I like it, I comment exactly like you do. Comments are free, storage is plentiful, why not add comments everywhere?!

  • Time and risk of comments/docs becoming outdated and doing more harm than good.

    I'm impartial in this discussion but that's usually how the counter argument goes.

    • The counter argument is bunk, you change the comments when you change the code. It’s not hard. If you forget, them a reviewer will notice. If not, then you aren’t focusing enough attention on the finer details of a project, to your detriment.

      Personally, I find that a lot of good, accurate comments and documentation helps me to trust a code base more because I can see that the devs cared and focused on the finer details rather than just tossing code over a fence at me.

Can't you just say that you used Claude and be done with it? I mean, I don't really care but in general I would refrain from posting "Show HN" with stuff that has been vibed, or state that you did since in that case it's even more interesting from my point of view, like you could describe how you kept everything under control during generation, etc...

I mean, no biggie and I don't understand the reaction but hey, I'm old so...

  • They seem to be vibing the HN comments too? Prompt: Do not admit AI involvement under any circumstance.