Discussing Code Commit in Projects

Discussing Code Commit in Projects

Daily short news for you
  • Continuing to update on the lawsuit between the Deno group and Oracle over the name JavaScript: It seems that Deno is at a disadvantage as the court has dismissed the Deno group's complaint. However, in August, they (Oracle) must be held accountable for each reason, acknowledging or denying the allegations presented by the Deno group in the lawsuit.

    JavaScript™ Trademark Update

    » Read more
  • This time last year, I was probably busy running. This year, I'm overwhelmed with work and have lost interest. But sitting too much has made my belly grow, getting all bloated and gaining weight. Well, I’ll just try to walk every day to relax my muscles and mind a bit 😮‍💨

    The goal is over 8k steps 👌

    » Read more
  • Just a small change on the Node.js homepage has stirred the community. Specifically, when you visit the homepage nodejs.org, you will see a button "Get security support for Node.js 18 and below" right below the "Download" button. What’s notable is that it leads to an external website outside of Node.js, discussing a service that provides security solutions for older Node.js versions, which no longer receive security updates. It even stands out more than the Download button.

    The community has condemned this action, stating that it feels a bit "excessive," and suggested consulting them before making such decisions. On the Node side, they argue that this is appropriate as it is from a very significant sponsoring partner. As of now, the link still exists. Let's wait to see what happens next.

    » Read more

Issues

Every day, we constantly code and fix bugs along with other team members. Suddenly, one fine day, the tester screams about an error that you had fixed weeks ago. You immediately speak up, stating that you had already fixed it and you need to prove it to the tester. You open the commit history and boom... commit, fix bug, fix some bug... are the things that hit your eyes. And guess what? Those are the commit messages you made!

Now, how do you find that specific commit? You torture yourself wondering why you didn't commit more clearly at that time. Don't worry, everyone makes mistakes, and mistakes are meant to be fixed. But what's more important is that you have to recognize that you made a mistake and share your method of improvement!

Commit Clearly

That's right, first and foremost, try to come up with clear messages that are action-oriented towards the target.

For example:

  • Fix the issue of missing names in the list of provinces/cities
  • Add the feature to update provinces/cities
  • Add the Reference Documentation section to README.MD

I'm using Vietnamese as an example, but depending on the project's rules, you can also commit in English, but the essence and content should remain the same.

Add prefixes to messages

This is a method that many developers have applied in various projects on the social network platform Github. By using prefixes to categorize your common commit types in the project, you can easily differentiate and search for them.

In general, there will be some prefixes that developers self-agree upon, but it's not necessary to follow them.

Some commonly used prefixes are:

  • feat: add a new feature
  • fix: fix a bug
  • refactor: optimize an existing feature
  • style: changes that do not affect the meaning of the previous code, often related to the code formatting such as missing semicolons (;), removing spaces...

There are many other prefixes as well, which you can refer to in this article How to Write Better Git Commit Messages – A Step-By-Step Guide.

For example:

  • fix: Fix the issue of missing names in the list of provinces/cities
  • feat: Add the feature to update provinces/cities
  • docs: Add the Reference Documentation section to README.MD

Try to separate the meaning of each commit

I understand that many of you (including me) often encounter situations where while working on one feature or fixing a specific bug, we suddenly discover another issue and fix it conveniently. Then, when it comes to commit, we only write a generic message like "fix some bugs". This may be convenient, but it complicates tracking. Therefore, try to fix them one by one in a clear manner. Don't be afraid of using multiple commits and commit clearly.

Apply Git Flow

Git flow is a term that refers to the "conventions" followed by a team in a project. For example, a project might have 3 branches: master to store the latest code, release to determine the production-ready features, and develop to develop features for release.

In addition, Git Flow also defines the branching and merging flow while developing features. There is a well-known Git Flow called Git-Flow Cheatsheet which developers can refer to.

Lastly, use GUI tools for management

If you are comfortable with the command-line interface, that's okay. But personally, there have been many times when I had to use tools for managing Git. I find it convenient and it helps me keep track of the project's flow.

Nowadays, almost all code editors integrate or have plugins that allow easy and convenient Git management. Developers can explore further based on the specific tools they are using.

In conclusion

The above sharing is based on my experience, and it is up to the developers to apply them depending on their team's work and project flow. If you find them not suitable or have better suggestions, please leave a comment and let me and others know!

Premium
Hello

The secret stack of Blog

As a developer, are you curious about the technology secrets or the technical debts of this blog? All secrets will be revealed in the article below. What are you waiting for, click now!

As a developer, are you curious about the technology secrets or the technical debts of this blog? All secrets will be revealed in the article below. What are you waiting for, click now!

View all

Subscribe to receive new article notifications

or
* The summary newsletter is sent every 1-2 weeks, cancel anytime.

Comments (2)

Leave a comment...
Avatar
Trần Cường3 years ago

Thực sự mình không để ý đến cái này, mình chỉ commit theo lý do tại sao

Reply
Avatar
Linh Trần3 years ago

Giờ mình mới biết có commit theo

Reply