Member-only story

3 Simple Ways To Communicate Effectively As Software Engineers

Effective programming is about communicating well. Here are three specific ways we can do this through our interactions with code

JW
4 min readAug 28, 2023
Photo by Richy Great on Unsplash

Programming is a form of communication. Just as we use language to convey ideas and express ourselves to others, we use code to communicate our intentions to other developers. And just like with language, good communication is essential in programming to ensure that our ideas are conveyed clearly and effectively.

Programs are meant to be read by humans and only incidentally for computers to execute.

Donald Knuth.

Here are some best practices that I try to follow when communicating through my code and interactions with other engineers:

1. Keep Commit History Clean

A messy commit history can make it difficult to understand how a project has evolved over time, especially if it spans several years or multiple developers.

Bad commits and PRs can create confusion and make it harder to find issues and debug code later on. Here are some tips for keeping your commit history clean:

  • Clarity: Write clear and concise commit messages that…

--

--

JW
JW

Written by JW

Front-End Software Engineer, and avid learner of history.

No responses yet