{"path": "/posts/it-s-time-to-retire-conventional-commit/", "title": "It's time to retire conventional commit · Bruno Dias", "html": "<!doctype html>\n<html lang=\"en\">\n<head>\n  <meta charset=\"utf-8\">\n  <meta name=\"viewport\" content=\"width=device-width, initial-scale=1\">\n  <meta name=\"description\" content=\"It&#x27;s time to retire conventional commit\">\n  <title>It&#x27;s time to retire conventional commit · Bruno Dias</title>\n  <link rel=\"canonical\" href=\"https://diasbruno.github.io/posts/it-s-time-to-retire-conventional-commit/\" data-post-metadata>\n  <meta name=\"author\" content=\"Bruno Dias\" data-post-metadata>\n  <meta property=\"og:type\" content=\"article\" data-post-metadata>\n  <meta property=\"og:title\" content=\"It&#x27;s time to retire conventional commit\" data-post-metadata>\n  <meta property=\"og:url\" content=\"https://diasbruno.github.io/posts/it-s-time-to-retire-conventional-commit/\" data-post-metadata>\n  <meta property=\"article:published_time\" content=\"2023-02-10T14:31:55Z\" data-post-metadata>\n  <link rel=\"icon\" href=\"/assets/site/signature.svg\" type=\"image/svg+xml\">\n  <link rel=\"alternate\" type=\"application/atom+xml\" title=\"diasbruno\" href=\"/atom.xml\">\n  <link rel=\"alternate\" type=\"application/json\" href=\"/posts/it-s-time-to-retire-conventional-commit/content.json\">\n  <link rel=\"stylesheet\" href=\"/assets/site/tokens.css\">\n  <link rel=\"stylesheet\" href=\"/assets/site/site.css\">\n  <link rel=\"stylesheet\" href=\"/assets/site/footer.css\">\n\n</head>\n<body class=\"light\">\n<div id=\"site-page\">\n<a class=\"skip-link\" href=\"#content\">Skip to content</a>\n<header class=\"site-header\">\n  <a class=\"brand\" href=\"/\" data-site-navigation aria-label=\"Bruno Dias, home\">\n    <img src=\"/assets/site/signature.svg\" width=\"24\" height=\"34\" alt=\"\">\n  </a>\n  <nav aria-label=\"Main navigation\">\n    <ul>\n<li><a class=\"nav-vrn\" href=\"/vrn/\" data-site-navigation><span class=\"nav-label\">vrn</span> <span class=\"nav-badge\">research</span></a></li>\n<li><a class=\"nav-posts\" href=\"/posts/\" data-site-navigation aria-current=\"location\">Posts</a></li>\n<li><a class=\"nav-projects\" href=\"/projects/\" data-site-navigation>Projects</a></li>\n<li><a class=\"nav-about\" href=\"/about/\" data-site-navigation>About</a></li>\n</ul>\n  </nav>\n</header>\n\n<main class=\"section\" id=\"content\" tabindex=\"-1\">\n  <article class=\"post-detail\">\n    <header class=\"section-header\">\n      <p class=\"post-category\">Post</p>\n      <h1>It&#x27;s time to retire conventional commit</h1>\n\n      <p><time datetime=\"2023-02-10T14:31:55Z\">2023-02-10</time></p>\n    </header>\n    <div class=\"post-columns\">\n      <section class=\"post-body\" aria-label=\"Article\">\n\n<p>This commit style is extremely popular.\nIt tries to help to organize\na project's version control history.</p>\n<p>It probably still have some application\nor where it can used.</p>\n<p>Unfortunately, it doesn't help to solve\nan important issue when you need to analyze\nand maintain a project.</p>\n<p>It's about identifying and grouping related\ncommits.</p>\n<p>It's kind silly saying it out loud,\nbut this is something that was overlooked\nmostly because there are very few people\ndoing serious hardcore git commands\nor analyzing repositories.</p>\n<p>After doing some code and repository analyses,\nthe most annoying thing to do is relating commits\nwith external tools.</p>\n<p>It can take a really long time\nand it's annoying because it should\nbe easy to automate.</p>\n<p>Here is an example:</p>\n<p><code>E-1</code> is an epic and <code>T-1</code> e <code>T-2</code> are tasks of this epic.\nIf you want to find E-1, you can search for T-1 and T-2,\nor the epic itself if you create the epic branch.</p>\n<pre><code>hash commit\n5555 feat: added page for resource\n4444 refator: other peoples work\n3333 feat: added service for resource\n2222 fix: other peoples work\n1111 feat: added http stuff for resource\n0000 ....\n</code></pre>\n<p>We know <code>1111</code>, <code>3333</code> and <code>5555</code> are related,\nbut it's hard to automate, so we have to do it\nmanually.</p>\n<p>Also, when quering a repository,\nthese tags have pretty much no use.</p>\n<p>If you have a failure in the process,\na feature gets to production\nand the team decide that it will be the best\nto revert the whole thing, it can be very challenge\nbecause more and more stuff will be pushed\nto the master/main branch.</p>\n<p>Using the identifier of your project management system\nis a simple way an have a lot of benefits when you need\nto query the repository.</p>\n<p>This is not a new thing. This style is out there as well...</p>\n<pre><code>hash commit\n5555 T-2 | added page for resource\n4444 T-Y | other peoples work\n3333 T-1 | added service for resource\n2222 T-X | other peoples work\n1111 T-1 | added http stuff for resource\n0000 ....\n</code></pre>\n<p>With an external identifier, it help to query the history\nin a very efficient way and it become very shell friendly.</p>\n<p>Here is a command to query an epic <code>E-1</code>:</p>\n<p>git log --oneline --grep=&quot;^T-[12]&quot;</p>\n<pre><code>hash commit\n5555 T-2 | added page for resource\n3333 T-1 | added service for resource\n1111 T-1 | added http stuff for resource\n</code></pre>\n<p>With query you can easily extract a .diff\nto revert an entire feature without suffering.</p>\n\n      </section>\n      <aside class=\"post-links\" aria-labelledby=\"post-links-heading\">\n        <h2 id=\"post-links-heading\">Links</h2>\n        <ul>\n<li><a href=\"/posts/\" data-site-navigation>All posts</a></li>\n        </ul>\n      </aside>\n    </div>\n  </article>\n</main>\n\n<footer class=\"site-footer\">\n  <div class=\"site-footer-inner\">\n    <a class=\"site-footer-home\" href=\"/\" data-site-navigation>Bruno Dias</a>\n    <ul aria-label=\"Footer links\">\n      <li><a href=\"https://github.com/diasbruno\">GitHub</a></li>\n      <li><a href=\"/atom.xml\">Atom feed</a></li>\n    </ul>\n  </div>\n</footer>\n\n</div>\n<script type=\"module\" src=\"/assets/site/navigation.js\"></script>\n</body>\n</html>\n"}
