Skip to content
This repository has been archived by the owner on Dec 31, 2024. It is now read-only.

Commit

Permalink
How to communicate tech stuff to non-tech people
Browse files Browse the repository at this point in the history
  • Loading branch information
BrunoMVPCosta committed Apr 27, 2024
1 parent 0c12490 commit 4b488d9
Show file tree
Hide file tree
Showing 6 changed files with 137 additions and 171 deletions.
2 changes: 1 addition & 1 deletion _data/authors.yml
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ brunomvpcosta:
# Used at the bottom of each page and at the top of the `about` layout
# Markdown enabled, can use multiple paragraphs (enabled by `|`)
about: |
I’m Bruno Costa, a software engineer from Porto, Portugal and this is my little corner on the internet. Here I share some of my thoughts.
I’m Bruno Costa, a technology leader from Porto, Portugal and this is my little corner on the internet. Here I share some of my thoughts.
# This photo will be used in the about section
picture:
Expand Down
4 changes: 2 additions & 2 deletions _posts/2024/2024-03-27-redis-gave-up-key-value.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ share: true
First things first, the title is from the amazing joke Erik Bjäreholt did on X (ex-twitter). 

<center>
<blockquote class="twitter-tweet" data-dnt="true">
<blockquote class="twitter-tweet" data-dnt="false">
<p lang="en" dir="ltr">Redis is no longer open source?<br>I guess they gave up on their key values 🥁</p>
&mdash; Erik Bjäreholt (@ErikBjare)
<a href="https://twitter.com/ErikBjare/status/1771474971564318842?ref_src=twsrc%5Etfw">March 23, 2024</a>
Expand All @@ -30,7 +30,7 @@ A typical move is to move their license to a dual source-available license. [Ela
One question I asked on X was how did it affect the revenue and customers. 

<center>
<blockquote class="twitter-tweet" data-dnt="true">
<blockquote class="twitter-tweet" data-dnt="false">
<p lang="en" dir="ltr">Redis adopts dual source-available licensing.
<br><br>Is there any public available research to understand the impact in the revenue of the company that made these decisions in the past? Did it increase or decrease?
<br><br>And how about the providers? Did the cost move to the clients?
Expand Down
43 changes: 43 additions & 0 deletions _posts/2024/2024-04-27-tech-ideas-to-non-tech-people.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,43 @@
---
layout: post
title: "Bridging the Gap: How to Communicate Complex Tech Ideas to Non-Technical Audiences"
date: "2024-04-27 00:00:00"
tags: []
permalink: tech-ideas-to-non-tech-people
description: "Stuck translating tech jargon? Learn how to communicate clearly and use creative analogies to convey difficult technical ideas to non-technical audiences"
comments: true
share: true
---


So, you have a killer feature or an amazing idea for your company, but explaining it to your boss or the marketing team is like explaining rocket science to a 4 year old?

The struggle is real. Throughout my career, I have experienced this myself, I have witnessed great engineers struggle to explain an idea to someone non-technical or even to a tech executive and I have also witnessed great people doing it seamlessly. 

It’s something that even more experienced engineers can struggle with. I remember having conversations with director-level ICs where they said “It would be much easier to just trust us to do the work”. It would probably be easier to move forward, not necessarily in the direction the company needs, though.

So, today I give some tips to reduce the tech talk gap and ensure everyone’s on the same page.

**Ditch the jargon** 

We engineers love our acronyms and technical terms, but to the uninitiated, they sound like gibberish. Instead of "API integration," explain it as "connecting our app to other services."

**Think of analogies**

People understand everyday things. Explain a complex topic by comparing it to a recipe or a decision tree. For instance, to explain how a firewall works we can use something like “think of a security at a nightclub. The security guard checks people and allows only guests with invitation to enter the club. Similarly, the firewall checks incoming data (people) and only allows authorized data (guests with invitation) to enter the network (club)”.

**Focus on Benefits, Not Mechanics**

Your audience doesn't care how the internals work, they care about where it takes them. Explain the "what" and "why" of your tech concept. Instead of "We're implementing a new caching system," say "This will make the app load lightning fast, giving users a smoother experience."

**Keep it Simple (and Short)**

Attention spans are limited, especially for executives. Avoid too much information. Break down complex concepts into manageable pieces and concentrate on the most important lessons.

**Check for Understanding**

Communication is a two-way street. Don’t just **deliver** the message, **have a conversation** with them. Leverage visual support like flowcharts or other diagrams and ask questions to ensure your message is being received. If they look at you like you’re an ET, you may need to adapt your approach.

**Bonus tip: Tailor your message to the audience.**

If you are explaining adding a caching system to a product manager, you may want to highlight the smother user experience and higher conversation rates. Explaining the same topic to someone from finance, you may want to highlight the cost savings and the revenue growth of this solution.
4 changes: 2 additions & 2 deletions _site/about/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -124,7 +124,7 @@
<meta name="twitter:card" content="summary" />
<meta property="twitter:title" content="About" />
<script type="application/ld+json">
{"headline":"About","name":"thrownewexception();","author":{"@type":"Person","name":"Bruno Costa"},"@type":"WebSite","description":"@brunomvpcosta’s internet little corner to write about scalability, architecture, software and more stuff.","url":"http://localhost:4000/about/","@context":"https://schema.org"}</script>
{"name":"thrownewexception();","headline":"About","author":{"@type":"Person","name":"Bruno Costa"},"@type":"WebSite","description":"@brunomvpcosta’s internet little corner to write about scalability, architecture, software and more stuff.","url":"http://localhost:4000/about/","@context":"https://schema.org"}</script>
<!-- End Jekyll SEO tag -->

</head>
Expand Down Expand Up @@ -172,7 +172,7 @@
<h1 class="page-title">About</h1>
<hr/>

<p>I’m Bruno Costa, a software engineer from Porto, Portugal and this is my little corner on the internet. Here I share some of my thoughts.</p>
<p>I’m Bruno Costa, a technology leader from Porto, Portugal and this is my little corner on the internet. Here I share some of my thoughts.</p>


<!--
Expand Down
Loading

0 comments on commit 4b488d9

Please sign in to comment.