• Benmore Brief
  • Posts
  • Simplify Coding: Communicating Ideas and Concepts with Developers.

Simplify Coding: Communicating Ideas and Concepts with Developers.

Many highly specialized fields adopt industry specific abbreviations, concepts, and acronyms that can make it difficult to communicate effectively with individuals outside of the "know". In this article, we discuss some tips and tricks to navigate these discussions.

This article was manually written. No AI.

Let’s integrate AI into that end-user’s registration workflow using the GPT API to auto-translate languages to English- make sure you use a structured output and validate the JSON.

The above sentence would make sense to any developer that’s worked with OpenAI’s ChatGPT models in an application but would probably come across as a foreign language to someone who isn’t a developer or actively working in technology.

Just like bankers throw around complicated jargon, developers and tech professionals are no different. Now, this is all done for a reason. Software is a game of abstraction, and developers are dealing with complicated concepts that oftentimes are simplified into jargon to streamline communication.

For example, the above sentence could be rewritten as:

Let’s implement ChatGPT’s language translation functionality into the people who are using our app’s signup pages. We should do this by going to OpenAI’s, the company behind ChatGPT, standard online programming interface - in which we can ping the gateways they set up and use their language translation in our own application. Furthermore, we need to be consistent in the response that ChatGPT responds with so we need to set up a standard return format that we can count on. We should make sure we set this setting, which is their structured output setting, when our application communicates with ChatGPT to ensure that our application doesn’t error out if ChatGPT malfunctions.

Whew! As you can see, this jargon exists for a reason, but that doesn’t mean you need to be blinded by it when you get into technical discussions with your developers. Below, we’ll discuss two methods to utilize when you find yourself in one of these technical discussions.

Benmore’s founder tools of the week:

Check out these tools to supercharge your growth.

Have ChatGPT on standby!

No joke, ChatGPT is excellent at deconstructing tech-language. If you find yourself in a technical discussion, go to ChatGPT, type in the jargon, and say: Explain this to me like I am five.

For example this is the output from ChatGPT using the original sentence.

You can follow up and ask ChatGPT to expand on specific parts of the response. For example, I am going to prompt it to expand on what JSON is:

Demand clarity from developers through visualizations.

So, when you’re consuming jargon, you can have ChatGPT as a helper to assist with your deconstruction. But what about when you’re working directly with developers, how can you assist them in breaking down concepts to you directly?

We’ve found that, at Benmore, visualizing concepts through whiteboarding is the easiest way to breakdown complex technical concepts.

Typically, we’ll use https://excalidraw.com/ to rapidly develop whiteboards that can visualize complex topics and make them consumable.

For example, here’s a whiteboard representation of the original sentence:

If you’re on a call with a developer, simply ask them to whiteboard their logic and send them the Excalidraw link. From there, the developer should be able to visualize the complex task for you and make it consumable.

Most actions in technology are a series of logical gates - if something happens, then do this. Because of this, whiteboarding the flow of the logic makes these complex flows understandable.

Bonus tip: brush up on the basics.

Most applications simply deal with creating data, reading data, updating data, and destroying data. (CRUD) If you have the time we’ve linked a couple basic explanations of common programming concepts below:

If you’re interested in getting started with us and learning how we manage technical communication with our clients, book a call below.

Let’s get started! Book a free consulting call:

Was this article helpful?

Login or Subscribe to participate in polls.