12 Effective Writing Tips for Software Engineers
Tags: softskills, communication, slack
Published: 2023-01-25 12:30:00

---
title: 12 Effective Writing Tips for Software Engineers
published: true
description: 
tags:
- SoftSkills
- Communication
- Slack
cover_image: https://dev-to-uploads.s3.amazonaws.com/uploads/articles/rahllezutw3kg87nm5c5.jpg
# Use a ratio of 100:42 for best results.
published_at: 2023-01-25 12:30 +0000
---

> Originally posted in [my personal blog](https://www.victorandcode.com/12-effective-writing-tips-for-software-engineers?ref=devto)

Excellent written communication skills are key to your software engineering career growth. It can help you deliver projects more successfully, create better relationships at work, grow faster as an engineer, and much more. The more senior the role, the more you're expected to communicate with other humans. This article summarizes some lessons I've learned about communicating more efficiently in the context of software development.

## Scope 📒

This article is mostly about written communication for **software engineers** but it'll probably also be helpful for other roles working in the software development lifecycle.

## What is effective communication 🤷

First, let's define what I call "ineffective communication." It's an exchange of messages which has one or many of these characteristics:

- Slow
- Frustrating
- Causes misunderstandings
- Consecutively makes people lose time and money

By contrast, for the purpose of this article, effective communication leads to fast and empathetic resolution of problems and the exchange of ideas with a minimum number of misunderstandings.

## List of communication tips ✍️

<p>
  <u>Know your audience</u>: Before you send any message, ask the following.
  What's their role? What knowledge do they have in the topic you're about to
  discuss? What timezone are they in? All of this will help guide how technical
  your vocabulary will be. It's very different to say, "Our server's overloaded
  with requests, and we're working to fix the load balancer," than saying,
  "We're having some issues with our servers but are working on it."
</p>

<p>
  <u>Have the key decision-makers in the conversation</u>: If you don't, you
  might not receive essential feedback or need to backtrack on the decision
  afterward. Make sure to involve the right people but not anyone else.
</p>

<p>
  <u>Be action-oriented, and propose solutions</u>: Avoid conversations of the
  type: - Hey everyone, did you see we have this problem - Yup, we have a
  problem - The end
</p>

<p>
  <u>Think about what follow-up questions the other person will ask</u>: Try to
  answer them in advance, so the number of messages in the exchange is
  minimized.
</p>

<p>
  <u>Use as few words as possible</u>: If your message is short, more people
  will read it, it'll avoid confusion and it'll take less time to make a
  decision. So, before sending your message, review it. Delete as many words as
  you can to keep the core message and avoid any fluf
</p>

<p>
  <u>Clearly state urgency and next steps</u>: Say, if your question is urgent,
  what's the impact? Is it blocking anyone?
</p>

<p>
  <u>Enumerate questions </u>: For multiple questions, it's easier to enumerate
  them so you can refer back to them and allow the other person to answer one by
  one.
</p>

<p>
  <u>If there's room for interpretation clarify! </u>: Believe it or not,
  <b>a lot of times</b>, small assumptions or misunderstandings will be highly
  costly. If there's something with some room for interpretation or too vague,
  get to the details. The simplest way of doing this is to ask, "So when you say
  [insert original part of their message], you mean [shorter paraphrased
  version]?"
</p>

<p>
  <u>Know when to change to videocall (or IRL conversation) </u>: Remember,
  written communication has limits. If the conversation is taking too long or
  you need to discuss live changes, you might be better off having a call
</p>

<p>
  <u>Think of solutions</u>: Lead the conversation by saying "We have this
  problem, and I've thought about some implications, so I think we have these
  options enumerate options. What do you think?". Sooner or later, you'll be the
  person to whom people come for answers.
</p>

<p>
  <u>Be kind </u>: You're (probably) talking to a person. Don't demand things;
  ask nicely. Say hi, and present yourself if you're talking to someone for the
  first time; you don't have to send your whole life's story, just a simple "Hey
  name, I'm an engineer at team investigating an issue related to invoicing, I
  could really use your help with the following...".
</p>

<p>
  <u>Respect people's attention</u>: Messaging apps are built to distract people,
  so be mindful and don't @ everyone, don't @ after working hours.
</p>

## Closing thoughts

Thanks for reading this far. I hope one or many of these tips are as helpful to you as they have been to me.
Again, communication is complex, but being a bit more thoughtful about what we write can go a long way.