Better Programming

Advice for programmers.

Follow publication

Member-only story

5 Ingredients of a Successful Technical Article

Shalitha Suranga
Better Programming
Published in
5 min readJul 1, 2021
two people reviewing a document in front of their computers
Photo by Scott Graham on Unsplash

Programmers usually write articles about experiments, their experience, technology, frameworks, and computer science. Some programmers write tutorials about the latest frameworks and tools. Meanwhile, some programmers love to write about computer science and complex concepts. All these programming-related articles are known as technical articles because the content of those articles delivers technical knowledge to a developer audience.

Every programmer tries to get more reads and views for their content with various strategies. However, every technical article won’t be popular and won’t reach thousands or millions of developers. Resharing has a massive effect on a particular technical article’s view count because it can increase the view count exponentially. Undoubtedly, high-quality content is the key to success behind every successful technical article. If we create high-quality content, everyone tends to reshare our articles.

I started writing technical articles about two years ago, and my total content view count is now close to one million on Medium. I tried different strategies to increase the views of my content by improving the quality. Finally I found the following strategies to be the highly effective, important ones.

The article is a journey, so make a better flow

Every piece of written content has three major sections: introduction, body, and conclusion. Likewise, programmers also need to have these three sections in their technical articles for better connectivity and flow. The great way to handle these sections better is to think of the article as a journey. First, in the introduction section, you can start the topic with its domain. In other words, you can start with a general explanation rather than being too specific. For example, if you are writing about Flutter desktop application development, a few words about desktop application development will get the reader on the right track.

As another example, I started this article with some details about technical content. It is always great to give a hint…

Create an account to read the full story.

The author made this story available to Medium members only.
If you’re new to Medium, create a new account to read this story on us.

Or, continue in mobile web

Already have an account? Sign in

Shalitha Suranga
Shalitha Suranga

Written by Shalitha Suranga

Programmer | Author of Neutralinojs | Technical Writer

Responses (5)

Write a response

Having studied the bible for many, many years, and having been a reformed Christian myself, I have come to believe that given the extreme enslavement and dismissal of women in scripture, "Laying with a man as with a woman" means a man should not…

I believe God loves everyone and if they love Him and Jesus they will follow their commandments which are very clear.

Yes I think fundamentalism and literalism are harmful.

Ugh the thought of apologists gives me a bit of indigestion...