How to Communicate Clearly as an Engineer

In my 14yrs career in engineering working for Big Tech companies such as Google and Uber, there is no other skill I used more than writing. And no, I don’t mean writing code. I mean English writing. Emails, Design Docs, Presentations, Feedback, Code Reviews, you name it. Here's how I make my written communication clear, effective, and punchy. 👇 Written communication can sometimes be daunting, especially for non-native speakers—like me. That’s why I wanted to share  the 6 questions that I use when writing anything. This helps me communicate more effectively and connect with my audience better. 1. Who is my target audience? Identify the specific group or individuals you are speaking to. Knowing your audience assists you in customizing your writing to meet their requirements and interests. 2. What is my main objective or purpose? Clarify the primary goal of your writing. Whether it's to inform, persuade, entertain, or educate, knowing your objective guides your content. 3. What key points do I want to convey? Identify the main idea or key points you want to communicate. This will help you stay focused and make sure your message is clear and logical. 4. Why should the reader care about this? Consider the value or benefit your writing offers to the reader. Highlight how it addresses their needs or solves a problem. 5. Is my writing clear, concise, and organized? Make sure your content is clear and easy to understand. Keep the flow logical and avoid using complex language or jargon that might confuse the reader. 6. Can I make my writing shorter? The answer is always yes. So make sure to edit edit edit. Brevity saves time for both the writer and the reader. What else would you add to this list? How does your writing process look like? ♻️ Please repost if you found this useful

As a software engineer, I've learned the hard way that details ≠ clarity. When communicating with executives, every extra word dilutes your message. Despite coaching and training, I still catch myself diving too deep and losing my audience – but recognizing this tendency and having the right tools has been helpful. Three insights that changed how I communicate complex technical concepts: - Lead with impact: Start with what matters most. For that exciting GenAI proposal? "This will transform how users experience our product" comes before any technical architecture. - Context before complexity: Show why it matters before how it works. Your audience needs to care before they'll dig into details. - Layer your message: Start high-level, then provide paths to technical depth. Not everyone needs your debugging journey. The reality? In today's world, you have seconds to make your point. The clearer you communicate, the more influence you'll have. That’s not to say we shouldn’t have the details in our head. It’s just part of getting stuff done.

🎨🖊️ "Draw two circles under a rectangle…" "Now, make the circles connect to the rectangle" - some of the instructions that were given to me by our Head of Architecture during a recent offsite. We engaged in an exercise that underscored the importance of clear and effective communication. Each participant paired up, with one partner facing a screen displaying an image and the other facing a blank wall with a pen and paper. The challenge? The partner facing the screen had to guide their teammate in drawing the image using only directional and descriptive language. This exercise was a powerful reminder of how crucial it is to be clear, descriptive and thoughtful when sharing requirements, feedback or instructions. In the world of technology, we often fall into the trap of using complex language, acronyms, and omitting details we assume are "obvious." This can lead to confusion, misunderstandings, rework, and ultimately, wasted time. The key takeaway? Being specific doesn't always mean being overly detailed or long-winded. There's a beautiful balance between being specific and descriptive. It's about conveying the right amount of information in a way that's easily understood. Here are some common pitfalls to avoid when striving for specificity in communication: - Overloading with Details: Focus on the most relevant information to avoid overwhelming your audience. - Using Jargon and Acronyms: Consider your audience and provide explanations when necessary. - Assuming Shared Knowledge: Provide necessary context to ensure understanding. - Being Vague: Use precise language to prevent misunderstandings. - Neglecting the Audience's Perspective: Tailor your communication to the needs and understanding of your audience. I am reminded of a quote by Mark Twain: "I apologize for such a long letter - I didn't have time to write a short one." Concise communication takes time and effort, but it's always worth it. In our fast-paced world, mastering the art of effective communication is essential. It not only enhances collaboration but also drives efficiency and innovation. #Communication #Leadership #EffectiveCommunication