, I talk about 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’ll find your individual area of interest, and what that you must bear 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 talk about the large advantages I’ve had from writing and a few classes I’ve realized from my writing.
You too can 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 replicate a bit on my writing journey and why writing technical articles is among the finest choices I’ve made to date in my profession.
- Studying the subjects higher: One of the simplest ways of studying is to show others. That is primarily what you’re doing when writing technical articles.
- Networking: You get to attach with a variety 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 method of economically supporting your self, although I preface that this shouldn’t be your major motivation to begin writing.
I consider the primary level on studying subjects outweighs some other profit I’ve had from writing. Writing offers an avenue to each educate others a couple of subject and concurrently additional deepen your data on a subject. Instructing others is one of the simplest ways to study one thing your self.
I discover it extremely rewarding to write down an article to show others whereas additionally additional enhancing my understanding of a subject by means of writing about it. I actually reckon this to be one of many best components of training technical writing, and a big motive I like to recommend that you just additionally write technical articles.
Sorts of technical articles
- “ …” programming articles
- Testing/reporting on new releases
- Educate a couple of subject
“” articles
A how-to article is an article detailing how one can do one thing inside programming. It could possibly be as particular as how one can 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 want to write down, as they match each inside what I get pleasure from writing about and the sorts of articles I obtain the inspiration to write down about. For instance, I make the most of a brand new framework in a venture, or find out about a subject (for example, context engineering), and write a selected article on how one can make the most of the framework, or how one can do one thing particular inside the subject.
Testing new releases
Lots of technical articles additionally concentrate on testing out and reporting on new releases. Recently, most of those revolve round testing new LLM fashions, such because the latest Qwen 3 launch or Grok 4. I often learn such articles to remain on high of all the things taking place 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.
Instructing a couple of subject
One other widespread technical article is one educating a couple of particular subject. These articles normally cowl wider areas than the “how-to” articles, however might be enormously useful. These sorts of articles might be introductory articles to a subject, a deep dive article for skilled readers, or something in between. I normally learn such articles when entering into a brand new subject, or to remain on high of subjects I’m notably concerned about. It’s best to word that these articles are sometimes very time-consuming to make, however they typically 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 entails discovering the sorts of articles:
- You get pleasure from writing (and also you’re good at writing)
- Your readers get pleasure from studying
Your area of interest might be tremendous particular (i.e., solely Python AI tutorials), or it could actually forged a wider internet, comparable to “How-to” tutorials for AI.
To seek out your individual area of interest, I like to recommend you attempt writing the completely different article sorts I listed within the final part. An important side is to seek out one thing you get pleasure from writing about. This could, in fact, additionally change over time. After discovering what you get pleasure from writing about, that you must begin writing articles often. I write round as soon as every week, which I believe is an efficient steadiness between constantly sharing my data on-line, whereas additionally avoiding artistic burnout by writing too typically.
Moreover, I additionally discover that it’s normally a lot simpler to write down about subjects on which you may have some background data. For me, for instance, I write largely about AI, which I work with on daily basis at my full-time job. This offers me a variety of background data, which is helpful for the article, and offers me with inspiration for subjects to write down about.
My learnings
Enhancements for every article
I’ve realized loads by means of 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 collection 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 it’s whereas scrolling social media or whereas taking a stroll. I thus advocate preserving a listing of various concepts you need to write about. I maintain this record in Google Hold, so I can entry it each by way of my cellphone and laptop.
After I then sit down on Sundays to write down an article, I can select one from my record of concepts. I discover this a lot less complicated than having to provide you with a subject to write down about on the spot.
Article define
After I selected my thought to write down about, I created a top level view 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 potential. For instance, suppose I consider one thing I’ve to incorporate within the article whereas writing (for instance, an article I need to seek advice from). In that case, I write “TODO to seek out the article to seek advice from 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. Preserving the interruptions to a minimal makes you a way more environment friendly author, whereas it’s also possible to bear in mind all the things that you must do, utilizing the TODOs.
Guidelines
One other necessary studying I made is to keep up a guidelines of all the things that you must do for every article. There are a variety of various things that you must bear in mind to do, and easily sustaining a guidelines you fill out for every article ensures you bear in mind all the things. My guidelines, for instance, contains:
- 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 put up on LinkedIn and X
- …
Writer
I additionally extremely advocate discovering a writer in your articles. This could possibly be a publication on Medium or a separate web site comparable to Towards Data Science. Having a writer ensures much more individuals view your article, which is crucial each in your motivation when writing and for sharing your data with as many individuals as potential.
Hold writing
I genuinely consider consistency is among the most necessary elements when writing. It’s best to discover a particular interval you possibly can preserve over a time period. It could possibly be as soon as a month, as soon as every week, or some other interval you like. It’s best to then attempt to persist with that schedule over time, whereas enhancing one aspect of your articles every time. Over time, you will see that that your articles vastly enhance, and extra persons are studying your content material.
Conclusion
On this article, I’ve mentioned how one can write technical articles. I mentioned the various kinds of technical articles you’ll find on-line and the way you’ll find your individual area of interest when writing. I consider writing offers huge advantages, not just for the individuals studying, but in addition for the writer explaining a subject. That is additionally the explanation I’ve saved writing over time. Lastly, I mentioned a few of my very own learnings from writing, comparable to preserving 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
