commit messages are optional - eviltoast
  • Serinus@lemmy.world
    link
    fedilink
    arrow-up
    23
    ·
    4 months ago

    But shouldn’t be. How hard is it to summarize your work in a few words? Even a bad description is more memorable than a hash.

    • magic_lobster_party@kbin.run
      link
      fedilink
      arrow-up
      4
      ·
      4 months ago

      The post mentions that these are for commits in a merge request before squash. When they’re squashed a proper message is given.

      • Serinus@lemmy.world
        link
        fedilink
        arrow-up
        9
        ·
        4 months ago

        Sure, but how much of that is justification and backpedaling?

        If it’s worth a commit, it’s worth a description. “Address vulns” “fix config” “remove files”. It doesn’t take much. Even if it’s just “more address vulns”.

        • magic_lobster_party@kbin.run
          link
          fedilink
          arrow-up
          3
          ·
          edit-2
          4 months ago

          Often I commit because I have to jump to another branch, so I want to save my progress. This means I can be in the middle of something, so I write a trash message.

          All those messages will disappear anyway after the merge request, because we use a squash policy. I can spend more time thinking of a more proper commit message when writing the merge request.

            • magic_lobster_party@kbin.run
              link
              fedilink
              arrow-up
              1
              arrow-down
              1
              ·
              4 months ago

              I don’t like stash for this purpose. What if I have to jump to a different branch a second time? Should I stash again?

              It can be difficult to know which stash belongs to which branch. Nah, I rather just commit so I don’t need to bother with that confusion.

              • lad@programming.dev
                link
                fedilink
                English
                arrow-up
                3
                ·
                4 months ago

                I agree that stash gets lost easier than a branch, but

                It can be difficult to know which stash belongs to which branch

                you know, stash also has a message to it, and afaik it remembers what branch you were on when stashed

      • lad@programming.dev
        link
        fedilink
        English
        arrow-up
        7
        arrow-down
        2
        ·
        4 months ago

        Also, squashing is a pretty bad practice as it is. I can understand that it may make sense sometimes, but most of the time if you don’t commit every other character you input, you’re better off leaving some history of how your code evolved and what changes were coming together

        • magic_lobster_party@kbin.run
          link
          fedilink
          arrow-up
          7
          arrow-down
          1
          ·
          edit-2
          4 months ago

          I think squashing is great and I would never want to go back. It helps ensuring:

          • All commits in main have useful messages. No more “fix pipeline errors”, “fix MR comments”, etc.
          • Ensures pipeline has been successful with all commits in main. No need to guess which commits will build and won’t build.
          • Easy to revert commits.
          • Eliminates incompressible history because someone had a bad day with git.
          • Encourages frequent commits. No need to ensure all commits are perfect and good in their own right. Commit when you want to commit even if it’s incomplete work.

          And IMO, if your work warrants multiple commits, then it probably also warrants multiple merge requests. Merge requests should be rather small to make it easier to review.

          Edit: another good thing is that when we decide to release, we can easily look through the commit history for a change log. No more sifting through minor fixes commits.

              • onlinepersona@programming.dev
                link
                fedilink
                arrow-up
                1
                arrow-down
                2
                ·
                4 months ago

                It’s more about the tooling. IDEs make it really simple.

                Also people get scared when they hear it because of utterances like yours. I’m dumb af. Git rebase for your use cases can be renamed to “git edit-history $fromCommit”. Nothing special about it.

                Anti Commercial-AI license

          • eclipse@lemmy.world
            link
            fedilink
            arrow-up
            3
            ·
            edit-2
            4 months ago

            I agree with most of these but there’s another missing benefit. A lot of the time my colleagues will be iterating on a PR so commits of “fuck, that didn’t work, maybe this” are common.

            I like meaningful commit messages. IMO “fixed the thing” is never good enough. I want to know your intent when I’m doing a blame in 18 months time. However, I don’t expect anyone’s in progress work to be good before it hits main. You don’t want those comments in the final merge, but a squash or rebase is an easy way to rectify that.

          • lad@programming.dev
            link
            fedilink
            English
            arrow-up
            1
            arrow-down
            1
            ·
            4 months ago

            Merge requests should be rather small to make it easier to review.

            With this I wholeheartedly agree

            if your work warrants multiple commits, then it probably also warrants multiple merge requests.

            With this not so much, but if you keep your merge requests so small, squashing them is no big deal, that’s a good counterexample for my previous point.

            another good thing is that when we decide to release, we can easily look through the commit history for a change log. No more sifting through minor fixes commits.

            That still requires you to write meaningful messages, just a bit rarer. We do have trouble with change logs, but we had exact same problems when people squashed left and right. Maybe squashing helps self-discipline, though, I haven’t thought about it that way

  • zygo_histo_morpheus@programming.dev
    link
    fedilink
    arrow-up
    1
    ·
    edit-2
    4 months ago

    When I’m just locally iterating on stuff I’ll usually do a git commit -m "WIP: Description of what I'm trying to do" and then git commit --amend to it. A bit more ergonomic than stashing if I want to switch branches imo. I can also go back to old versions if I want to through the reflog.

    git commit --fixup some-commit is also great for if I discover things in the review for example. You can then do git rebase master --autosquash to flatten them into the commit they belong to and that way you don’t have to bother with commit messages like “fixed typo”. Doing fixups for small fixes is good because it allows you to keep your mr broken up into several commits without also leaving in a bunch of uninteresting history.

    Can recommend checking out the –fixup section in the git documentation if you haven’t heard about --fixup before.