Was digging through a project at work today where some guy in 2014 made 100+ commits in a single day and the only one that had a comment said “upgrading to v4.0”.

    • VanillaGorilla@kbin.social
      link
      fedilink
      arrow-up
      11
      ·
      1 年前

      I had one of those and it was two in the night and I was tired and forgot what I did and committed stuff, I dunno.

      But normally I’m a good boy and prefix with the ticked id and write down the change and attempted fix.

  • f314@lemm.ee
    link
    fedilink
    arrow-up
    37
    ·
    1 年前

    Conventional commits all the way! Even if I don’t use the keywords (feat, fix, etc.) I always write the comment in imperative tense; the message should tell you what happens if you merge it.

    • hallettj@beehaw.org
      link
      fedilink
      arrow-up
      7
      ·
      edit-2
      1 年前

      I totally agree.

      Right now I’m on a new project with a teammate who likes to rebase PR branches, and merge with merge commits to “record a clean history of development”. It’s not quite compatible with the atomic-change philosophy of conventional commits. I’m thinking about making a case to change style, but I’ve already failed to argue the problem of disruption when rebasing PR branches.

    • key@lemmy.keychat.org
      link
      fedilink
      arrow-up
      5
      ·
      1 年前

      That’s pretty neat. Is there a forked version that adds ticket number as a mandatory first class citizen? Cause that’d be darn near perfect.

  • HairHeel@programming.dev
    link
    fedilink
    arrow-up
    25
    ·
    1 年前

    You get two options.

    Normally it’s a squashed commit of everything in a feature, with a commit message like:

    [JIRA-1234] - Descriptive but Concise Name of Feature
    

    But every now and then it’s multiple commits like:

    quick fix
    Ugh, fix typo
    fuck fuck why doesn’t it work
    Oh, I’m stupid
    
      • tvbusy@lemmy.dbzer0.com
        link
        fedilink
        English
        arrow-up
        5
        ·
        1 年前

        There are already some attempts but I don’t think it will work, harmful even. Best case scenario, the AI can understand the code as well as a senior engineer from another company. All they can know without the context is what was changed, which is useless. We need the reason why the commit was made, not what was changed. The info is not there in the first place for the AI to try to extract.

  • korstmos@kbin.social
    link
    fedilink
    arrow-up
    11
    ·
    1 年前

    The change written as a command

    Until I get frustrated by something and just start committing “yeet”

  • noeontheend@beehaw.org
    link
    fedilink
    arrow-up
    11
    ·
    edit-2
    1 年前

    My commits tend to be pretty verbose. Here’s an example log from one of my projects.

    I follow the standard imperative style for the commit title, and then I use the body to summarize any important internal changes, reflect on the overall project status (for example, what milestones this commit crosses or what other work it might enable or require), and state what I’m going to work on next. I’m sure some people find it too wordy, but I like having the commit history show lots of details about the overall status.

    Edit: I always have a descriptive summary, i.e., never one word commits or similar.

      • fmstrat@lemmy.nowsci.com
        link
        fedilink
        arrow-up
        2
        ·
        1 年前

        I’m not sure I do. I wouldn’t want to read all that just to find the item that broke. Might be faster to read the code.

          • fmstrat@lemmy.nowsci.com
            link
            fedilink
            arrow-up
            1
            ·
            1 年前

            I use alias gl='git log --graph --abbrev-commit --no-decorate --date=format:'\''%Y-%m-%d %H:%M:%S'\'' --format=format:'\''%C(8)%>|(16)%h %C(7)%ad %C(8)%<(16,trunc)%an %C(auto)%d %>|(1)%s'\'' --all' It will change your world.

            • noeontheend@beehaw.org
              link
              fedilink
              arrow-up
              2
              ·
              1 年前

              That is sexy. My only problem is that I tend to run my Git operations in a pretty small tmux pane on the side of my editing pane, so that layout ends up being too wide to fit well. I’ll definitely keep that alias around for when I have a full screen though!

              • fmstrat@lemmy.nowsci.com
                link
                fedilink
                arrow-up
                1
                ·
                1 年前

                Haha yea I have written a number of git and docker aliases over the years that are permanently in my dotfiles. I’m always in screen but perhaps will get into this newfangled tmux.

  • andrew@lemmy.stuart.fun
    link
    fedilink
    English
    arrow-up
    8
    ·
    edit-2
    1 年前

    When I eventually (usually) rebase, declarative statements of what the commit would accomplish if applied.

    When I am testing CICD or generally need to push more frequently for whatever reason, it’s humor and angst all the way.

    Ffffffuuuuuuuuu

    Pls, why

    Okay yeah that was important I guess.

    (⁠╯⁠°⁠□⁠°⁠)⁠╯⁠︵⁠ ⁠┻⁠━⁠┻

  • dark_stang@beehaw.org
    link
    fedilink
    arrow-up
    8
    ·
    1 年前

    They fluxuate wildly between short and informative messages like “fixed regex validation on property A” and “I fucking hate prettier” when the build pipeline fails because I had a line that was 2 characters too long.

    • Luvon@beehaw.org
      link
      fedilink
      arrow-up
      1
      ·
      1 年前

      On projects I setup I have prettier run as part of a commit hook. All files will be formatted at all times

  • majkeli@kbin.social
    link
    fedilink
    arrow-up
    5
    ·
    1 年前

    Developer Initials - Jira ticket number which includes the project abbreviation and the ticket number - brief description:

    DA - HHGTTG-42 - fix question answer format

    If you need details you look in the ticket.

    • ramplay@lemmy.ca
      link
      fedilink
      arrow-up
      2
      ·
      1 年前

      Developer intials seems a tad redundant since the commit is tied to author(s). But I guess it is only 2 extra char

  • The Doctor@beehaw.org
    link
    fedilink
    arrow-up
    5
    ·
    1 年前

    I try to follow the BLUF pattern: Bottom line up front. The first line is as short a description of the change (“Re-fixed a bug where a URL without a verb could crash the bot.”) with some detail following (“I thought I caught that a couple of years back…”)

    I try to save the detail for the code itself: Comments describe what I was thinking at the time for context, the code is the code. I don’t replicate the code comments in the commit message because having the same thing in two places means having to keep two things up to date, and that rarely goes well.

  • saigot@lemmy.ca
    link
    fedilink
    arrow-up
    5
    ·
    edit-2
    1 年前

    I like my company’s style:

    For issues:

    <jira ticket> - [program][deliverable] did this to fix that

    Problem: symptoms of the problem that future devs can use to figure out its the same problem

    Root cause: why this is broken

    Solution: how I fixed it, including the scope

    Testing: what testing it has it gone through

  • Manticore@beehaw.org
    link
    fedilink
    arrow-up
    5
    ·
    1 年前
    • “progress on [1], fixed linting [2]”
    • “[1] completed, setup for [2]”
    • “[3] and [4] completed”
    • “fixed formatting”
    • “refactoring [1] and [2]”
    • “fix variable typos”
    • “update logic in [2]”
    • “revert package.json and regenerate package-lock”

    All my commits have comments. I generally commit after completing a ‘block’ objective, a describe what that was but in very simple terms mostly in regards to the file/section with the most significant logic changes. I don’t always specify the file if I did tiny typos/linting/annotation across a bunch of them, because the logic is unaffected I know that the differences will be visible in the commit history.

    My weakness is that I don’t do it often enough. If I’m working on [2] for several hours, I’ll only commit when I consider it minimally-viable (completed 2), or when moving between machines ([further] progress on 2). And I have a bad habit of not pushing every time I commit, just at the end of the day or when moving between machines (though a messy rebase hopefully made that lesson stick), or if somebody else on the team wants to review an issue I’m having.