Ahmad Awais

SHARE


πŸš€ Emoji-Log β€” A New Way to Write Your Git Commit Messages and Changelogs

Ahmad AwaisAhmad Awais
πŸ™Œ Howdy! This piece is a part of my 2018 Year in Review (read the context) β†’

Emoji log is a new way to write your Git Commit Messages. I like emoji. I like ’em a lot. Programming, code, geeks, nerds, open source, all of that is inherently dull and sometimes boring. I improve that by using Emoji.

I also am a big fan of the Don’t Repeat Yourself (DRY) philosophy and believe writing better Git commit messagesβ€”ones that are contextual enough to serve as a changelog for your open source softwareβ€”is an important component of DRY.

One of the many workflows I’ve written is Emoji-Log, a straightforward, open source Git commit log standard. It improves the developer experience (DX) by using emoji to create better Git commit messages. For more check out my article on OpenSource.com

Emoji-Log’s philosophy

Instead of memorizing hundreds of emoji, I’ve learned it’s better to keep the categories small and general. Here’s the philosophy that guides writing commit messages with Emoji-Log:

  1. IMPERATIVE: Make your Git commit messages imperative. Write commit message like you’re giving an order.
    β€” Use βœ… Add instead of ❌ Added.
    β€” Use βœ… Create instead of ❌ Creating.
  2. RULES: A small number of categories are easy to memorize. Nothing more, nothing less. There are only six types of Emoji log. One should only use these six types and nothing else. Which are
    β†’ πŸ“¦ NEW: [Git Commit Message goes here]
    β†’ πŸ‘Œ IMPROVE: [Git Commit Message goes here]
    β†’ πŸ› FIX: [Git Commit Message goes here]
    β†’ πŸ“– DOC: [Git Commit Message goes here]
    β†’ πŸš€ RELEASE: [Git Commit Message goes here]
    β†’ βœ… TEST: [Git Commit Message goes here]
  3. ACTIONS: Make Git commits based on actions you take. Use a good editor like VSCode to commit the right files with commit messages.
🌟 I recommend that you check out and Star the Emoji-log repo β†’
πŸ“¨

TheDevTakeaway: Developers' Newsletter!

Takeaway my professional opinion about Open Source, JavaScript/Cloud, Full Stack Development, building a business, growing a family, and everything in between! Delivered to your inbox once a month. 🀣 I'm even funny some times. πŸ‘» I hate spam! Pinky Promise!

πŸ‘¨β€πŸ« Edutainer & teacher at VSCode.pro 🎩 Full-time #OpenSourcerer πŸ₯‘ OSS Developer Advocate 🌳 Node.js Foundation Community Committee Member 🦊 Google Developers Expert for Web πŸ”₯ Ridiculously hard-working Full Stack Web Developer πŸ˜‚ Hilarious comedian ⓦ Regular WordPress Core Developer πŸ“£ TEDx Speaker ✌️ Spends 50-80% of his time building professional FOSS (Free & Open Source Software) used by over 902,556+ Developers πŸ™Œ Cloud Community Evangelist 🎯 JavaScript & DevOps fanboy πŸ’œ Loves his wife (Maedah) πŸ• Learn more about Ahmad ↣

Say πŸ‘‹ on Twitter @MrAhmadAwais | Subscribe to the Developer's Takeaway!

πŸ”₯ CHECK OUT β†’