‹ BackHN Continuity

Thread

How to Write with an LLM

769 points · 420 comments · joeriddles

  1. semiquaver · · focus · HN ↗
    This would sound insane to me from two years ago but I have recently started insisting on writing all my own commit messages and pull request descriptions. I do usually have an agent review them for factual accuracy, but not rephrase them.

    It slows things down a bit, but in the best possible way. It has helped immensely to improve the depth of my understanding of the agent-generated code. When agents are doing everything its way too easy to “skim” diffs and not really absorb them.

    I always prided myself on my technical writing, and commit messages and PRs were a great place to hone that skill. I found that I missed it and my work is better now I’ve reclaimed that part of my old job back.

    1. LeafItAlone · · focus · HN ↗
      A big win of LLMs in my book is the absolute reduction of commit messages with just “fixes” or “updates”. Commit messages have become more meaningful and useful, even if far from perfect.

      We have one dev who uses LLMs to write the code, but still commits by hand. Most of his messages are of the type above, and none of them are useful.

      1. hobo123 · · focus · HN ↗
        But that's a code review issue. Nobody should get away with shoddy commit messages like that.
        1. vova_hn2 · · focus · HN ↗
          I don't think that many teams review commit messages as a part of code review. At least, I've never seen it "in the wild".
          1. hobo123 · · focus · HN ↗
            True, is mostly about the code being merged, but when reviewing a PR they might suggest that the dev write better commit messages in the future.
            1. dawnerd · · focus · HN ↗
              We have standards we ask devs to follow but I’m not going to make someone go back and change a commit message after the fact. I more care about pull request body copy and I think the rules we have for that have been pretty well adhered too. Don’t even need ai to enforce it.
Open on Hacker News to reply ↗

Unofficial Hacker News client; not affiliated with Y Combinator.