Skip to main content

Simpler alternative to Conventional Commits

TLDR: Just put the fucking Issue ID in the commit message, you asshat!

I keep reading about Conventional Commits, and I think they are somewhat contrived and over complicate a simple requirement of commits: What context was a change made for. As we all know, information is somewhat useless without context. And I feel the same what about commit messages. And the best context in a commit message a link to the original Ticket in the Issue Tracking system. Most Issue Tracking systems support linking to the SCM, so that you can have a bi-directional link. If you look at an issue you can have a list of SCM changes done for that issue. For example, here is a JIRA issue showing what code change was done for it:

And if I look into my SCM I can see the JIRA issues that were used to make changes:

And the way to do this is to always have the Issue ID in the commit message. That's it. JIRA has this feature, so does Git Hub. That's all you need to do. Every commit message should have the Issue ID in it. So you can follow back as to why a change was done. That's the context. It's pretty useless to me if I look into the SCM history and see shit like:

feat: allow provided config object to extend other configs

It's great that a feature was added, but why was it added? Who requested it? etc etc...

Comments

  1. AnonymousMay 24, 2022 at 7:16 PM

    That's only for your use case. Conventional commits are useful for other reason too, you asshat! For example, they can automatically generate the appropriate version bump for the next publish. Plus some people on small projects don't need issues for every commit, that's just a waste of time in certain cases, you asshat!

    ReplyDelete
    Replies
    1. AnonymousFebruary 11, 2023 at 8:06 AM

      It’s easier to aggregate discussion on an issue than a commit with most SCMs because you can discuss the feature that a commit is associated with before it’s implemented and after.

      If there’s no issue associated with the commit, the commit is probably not that important, the project is probably not that important or potentially you shouldn’t be doing it depending on your team’s workflow.

      Delete

Post a Comment

Popular posts from this blog

Postgres Timestamps and Java

Postgres timestamps are up to microseconds resolution. This can be seen here in the Postgres V13 docs . This means that if you are trying to save a ZonedDateTime type into to the DB, you should cut-off the Nano-seconds portion of the time. Otherwise, if you save a time with Nano secs, and you read that time back from the DB, you will have different times. This is because the time from the DB is missing the nano-secs. So how does one go about doing this? Rounding Nanoseconds Essentially do to this, first need to get the nano secs of the second via: Integer nanoSecs = zonedDateTime .get( ChronoField . NANO_OF_SECOND ) ; This amount now has to be converted to micro-secs by dividing by 1000. This removes the nano-seconds the amount. Don't forget that the nano-secs that we just removed by dividing may be more then 500. In which case you should add 1 to the microseconds. Then we need to multiply by 1000 to get the amount back in nano-secs. By doing this we turn all the nano-secs to ZERO...
Post a Comment
Read more

Gremlin Console with preloaded Air Routes Graph Data

I am currently learning Apache Tinkerpop . An excellent resource is the free online book PRACTICAL GREMLIN by Kelvin R. Lawrence . And one part of this following this book requires one to setup a Gremlin console. And this was a pain to do each time I would start reading/following the book. So I created a Docker Image which contains the Gremlin Console with the air-routes data preloaded so that you can start working immediately. Pull and Run Image docker pull srasul/gremlin-console-air-routes-data:latest docker run -it srasul/gremlin-console-air-routes-data:latest Example $ docker run -it srasul/gremlin-console-air-routes-data:latest Apr 12, 2020 10:24:01 PM java.util.prefs.FileSystemPreferences$1 run INFO: Created user preferences directory. \,,,/ (o o) -----oOOo-(3)-oOOo----- plugin activated: tinkerpop.server plugin activated: tinkerpop.utilities plugin activated: tinkerpop.tinkergraph gremlin> g ==>graphtraversalsource[tinkergraph[vertices:3742 e...
Post a Comment
Read more