, I focus on how one can write technical articles. I’ve been writing such articles for round 2.5 years, and I’ll undergo my experiences, how you will discover your individual area of interest, and what you have to keep in mind when writing an article.
The purpose of this text is to show about technical writing and the various kinds of technical articles. Moreover, I’ll focus on the large advantages I’ve had from writing and a few classes I’ve discovered from my writing.
It’s also possible to learn my article on Benchmarking LLMs and take a look at my website, which contains all my information and articles.
Desk of Contents
Motivation
My motivation for this text is that I’ve been writing articles for about 2.5 years. I made a decision to mirror a bit on my writing journey and why writing technical articles is among the greatest selections I’ve made thus far in my profession.
- Studying the subjects higher: One of the simplest ways of studying is to show others. That is basically what you’re doing when writing technical articles.
- Networking: You get to attach with a number of readers of your articles and different writers doing the identical as you. This presents alternatives each for gaining a following and studying from others.
- Monitization: In case you have sufficient readers, writing can be a approach of economically supporting your self, although I preface that this shouldn’t be your main motivation to begin writing.
I consider the primary level on studying subjects outweighs another profit I’ve had from writing. Writing gives an avenue to each educate others a few subject and concurrently additional deepen your information on a subject. Educating others is one of the simplest ways to study one thing your self.
I discover it extremely rewarding to jot down an article to show others whereas additionally additional enhancing my understanding of a subject by writing about it. I really reckon this to be one of many biggest elements of practising technical writing, and a major motive I like to recommend that you just additionally write technical articles.
Kinds of technical articles
- “Find out how to …” programming articles
- Testing/reporting on new releases
- Train a few subject
“Find out how to” articles
A how-to article is an article detailing the right way to do one thing inside programming. It may very well be as particular as the right way to make the most of a selected Python package deal, or as imprecise as how to use context engineering. These are the sorts of articles I desire to jot down, as they match each inside what I take pleasure in writing about and the sorts of articles I obtain the inspiration to jot down about. For instance, I make the most of a brand new framework in a mission, or find out about a subject (for example, context engineering), and write a particular article on the right way to make the most of the framework, or the right way to do one thing particular throughout the subject.
Testing new releases
Lots of technical articles additionally give attention to testing out and reporting on new releases. Recently, most of those revolve round testing new LLM fashions, such because the current Qwen 3 launch or Grok 4. I often learn such articles to remain on high of every little thing occurring within the AI area and to know the efficiency of various fashions. I additionally tried writing such articles myself for some time, however I discovered it a bit monotone.
Educating a few subject
One other frequent technical article is one educating a few particular subject. These articles normally cowl wider areas than the “how-to” articles, however may be enormously useful. These sorts of articles may be introductory articles to a subject, a deep dive article for knowledgeable readers, or something in between. I normally learn such articles when moving into a brand new subject, or to remain on high of subjects I’m significantly concerned with. You need to word that these articles are sometimes very time-consuming to make, however they usually characterize a few of the highest-quality articles I learn on-line.
Discovering your area of interest
When writing, it’s important to seek out your area of interest. Discovering your area of interest includes discovering the forms of articles:
- You take pleasure in writing (and also you’re good at writing)
- Your readers take pleasure in studying
Your area of interest may be tremendous particular (i.e., solely Python AI tutorials), or it could forged a wider web, similar to “How-to” tutorials for AI.
To seek out your individual area of interest, I like to recommend you strive writing the completely different article sorts I listed within the final part. Crucial facet is to seek out one thing you take pleasure in writing about. This will, in fact, additionally change over time. After discovering what you take pleasure in writing about, you have to begin writing articles often. I write round as soon as every week, which I feel is an efficient stability between constantly sharing my information on-line, whereas additionally avoiding inventive burnout by writing too usually.
Moreover, I additionally discover that it’s normally a lot simpler to jot down about subjects on which you might have some background information. For me, for instance, I write largely about AI, which I work with day by day at my full-time job. This offers me a number of background info, which is helpful for the article, and gives me with inspiration for subjects to jot down about.
My learnings
Enhancements for every article
I’ve discovered lots by writing for two.5 years. I see huge enhancements between my first article and my present articles. My purpose has all the time been to attempt to enhance one thing particular for every article. This manner, I can see appreciable enhancements over a sequence of articles. Thus, my first studying is to attempt to enhance one thing in every article you write.
Record of concepts
The concepts for my article normally come from subjects I work on, in addition to studying LinkedIn, X, and Medium. I then study extra concerning the subjects and write an article on them. Concepts can come at any time, whether or not or not it’s whereas scrolling social media or whereas taking a stroll. I thus advocate retaining an inventory of various concepts you wish to write about. I maintain this checklist in Google Hold, so I can entry it each by way of my cellphone and pc.
After I then sit down on Sundays to jot down an article, I can select one from my checklist of concepts. I discover this a lot easier than having to provide you with a subject to jot down about on the spot.
Article define
After I selected my concept to jot down about, I created an overview for the article. I discover that this makes the article simpler to learn (the content material is extra coherent), and it’s simpler for me to have an outline whereas writing the article. I do that by first writing down all of the headers and subheaders in my article, earlier than writing anything. This helps me scope what to incorporate and exclude in my article, and makes it simpler to maintain the crimson thread within the article. You’ll be able to naturally add or take away headlines in a while, however I discover that originally writing down all of the headlines makes the writing course of simpler and the output higher.
Whereas writing, I additionally attempt to interrupt the method as little as doable. For instance, suppose I consider one thing I’ve to incorporate within the article whereas writing (for instance, an article I wish to check with). In that case, I write “TODO to seek out the article to check with right here” in my article, after which proceed writing. After ending the article, I then got here again to this TODO and did the duty. This manner, you keep away from an interruption. I like to recommend minimizing the variety of interruptions whereas writing as a result of it takes fairly a little bit of time to get into the writing rhythm once more after being interrupted. Conserving the interruptions to a minimal makes you a way more environment friendly author, whereas you may also keep in mind every little thing you have to do, utilizing the TODOs.
Guidelines
One other necessary studying I made is to take care of a guidelines of every little thing you have to do for every article. There are a number of various things you have to keep in mind to do, and easily sustaining a guidelines you fill out for every article ensures you keep in mind every little thing. My guidelines, for instance, consists of:
- Add featured picture, subtitle, excerpt, tags, and class
- Undergo the article with Grammarly for spell verify
- Guarantee all code within the article has syntax highlighting
- Share the submit on LinkedIn and X
- …
Writer
I additionally extremely advocate discovering a writer on your articles. This may very well be a publication on Medium or a separate website similar to Towards Data Science. Having a writer ensures much more individuals view your article, which is important each on your motivation when writing and for sharing your information with as many individuals as doable.
Hold writing
I genuinely consider consistency is among the most necessary components when writing. You need to discover a particular interval you’ll be able to preserve over a time period. It may very well be as soon as a month, as soon as every week, or another interval you like. You need to then attempt to stick with that schedule over time, whereas bettering one aspect of your articles every time. Over time, you can see that your articles vastly enhance, and extra persons are studying your content material.
Conclusion
On this article, I’ve mentioned the right way to write technical articles. I mentioned the various kinds of technical articles you will discover on-line and the way you will discover your individual area of interest when writing. I consider writing gives huge advantages, not just for the individuals studying, but additionally for the creator explaining a subject. That is additionally the rationale I’ve saved writing over time. Lastly, I mentioned a few of my very own learnings from writing, similar to retaining a constant writing schedule, sustaining a guidelines for every article, and discovering a writer.
👉 Observe me on socials:
🧑💻 Get in touch
🔗 LinkedIn
🐦 X / Twitter
✍️ Medium
