Help Your Future Self

Photo by Daniel Schludi on Unsplash

Recently, I was looking at my commit messages. I wasn’t able to comprehend some of them. I thought to myself, “there must be a better way.”

Lucky, there is a research paper that addresses this question. “What Makes a Good Commit Message?”

It is the consolidation of:

  • 46 research papers
  • 50 secondary sources
  • 30 expert opinions

A good message must answer these two questions:

  1. Why was the change required?
  2. What was changed?

Moreover, the researchers followed an empirical approach. They constructed a data set from popular open-source repositories and created a machine-learning algorithm to classify good messages based on these two criteria.

Check the results from the link below:

--

--

Photo by Markus Spiske on Unsplash

I visualize a time when we will be to robots what dogs are to humans. And I am rooting for the machines. — Claude Shannon

The other day, an old guy asked me to send a soft copy via a messaging app. He had no clue on how to accomplish this task. Nor did he own a smartphone, and the recipient had no alternative channel to submit those documents.

The number of dependencies for trivial tasks is increasing.
Are we doing it right?

--

--