, 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 personal area of interest, and what it’s essential 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 big advantages I’ve had from writing and a few classes I’ve realized from my writing.
It’s also possible to learn my article on Benchmarking LLMs and take a look at my web site, which incorporates all my data 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 likely one of the finest selections I’ve made to this point in my profession.
- Studying the subjects higher: The easiest way of studying is to show others. That is primarily what you’re doing when writing technical articles.
- Networking: You get to attach with loads 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: When you have sufficient readers, writing can be a means 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 some other profit I’ve had from writing. Writing gives an avenue to each educate others a few 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 put in writing 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 major cause I like to recommend that you simply additionally write technical articles.
Varieties of technical articles
- “How one can …” programming articles
- Testing/reporting on new releases
- Educate a few subject
“How one can” articles
A how-to article is an article detailing methods to do one thing inside programming. It might be as particular as methods to make the most of a specific Python package deal, or as obscure as methods to use context engineering. These are the sorts of articles I choose to put in writing, as they match each inside what I take pleasure in writing about and the sorts of articles I obtain the inspiration to put in writing about. For instance, I make the most of a brand new framework in a venture, or find out about a subject (for instance, context engineering), and write a selected article on methods to make the most of the framework, or methods to do one thing particular throughout the subject.
Testing new releases
Quite a lot of technical articles additionally give attention to testing out and reporting on new releases. Currently, most of those revolve round testing new LLM fashions, such because the latest Qwen 3 launch or Grok 4. I frequently learn such articles to remain on high of every thing occurring within the AI area and to grasp the efficiency of various fashions. I additionally tried writing such articles myself for some time, however I discovered it a bit monotone.
Instructing a few subject
One other widespread technical article is one instructing a few particular subject. These articles normally cowl wider areas than the “how-to” articles, however will be enormously useful. These sorts of articles will be introductory articles to a subject, a deep dive article for skilled readers, or something in between. I normally learn such articles when stepping into a brand new subject, or to remain on high of subjects I’m notably enthusiastic about. It is best to be aware that these articles are sometimes very time-consuming to make, however they usually signify 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 sorts of articles:
- You take pleasure in writing (and also you’re good at writing)
- Your readers take pleasure in studying
Your area of interest will be tremendous particular (i.e., solely Python AI tutorials), or it may forged a wider internet, corresponding to “How-to” tutorials for AI.
To seek out your personal area of interest, I like to recommend you attempt writing the totally different article sorts I listed within the final part. A very powerful side is to seek out one thing you take pleasure in writing about. This may, in fact, additionally change over time. After discovering what you take pleasure in writing about, it’s essential begin writing articles frequently. I write round as soon as per week, which I believe is an efficient steadiness between constantly sharing my data on-line, whereas additionally avoiding artistic burnout by writing too usually.
Moreover, I additionally discover that it’s normally a lot simpler to put in writing about subjects on which you’ve got some background data. For me, for instance, I write largely about AI, which I work with day by day at my full-time job. This offers me loads of background data, which is helpful for the article, and gives me with inspiration for subjects to put in writing about.
My learnings
Enhancements for every article
I’ve realized rather a lot 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 or not it’s whereas scrolling social media or whereas taking a stroll. I thus suggest holding a listing of various concepts you wish to write about. I preserve this checklist in Google Hold, so I can entry it each by way of my telephone and laptop.
After I then sit down on Sundays to put in writing 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 put in writing about on the spot.
Article define
After I selected my thought to put in writing 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 doable. For instance, suppose I consider one thing I’ve to incorporate within the article whereas writing (for instance, an article I wish to consult with). In that case, I write “TODO to seek out the article to consult 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. Retaining the interruptions to a minimal makes you a way more environment friendly author, whereas you may as well keep in mind every thing it’s essential do, utilizing the TODOs.
Guidelines
One other essential studying I made is to take care of a guidelines of every thing it’s essential do for every article. There are loads of various things it’s essential keep in mind to do, and easily sustaining a guidelines you fill out for every article ensures you keep in mind every 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 suggest discovering a writer to your articles. This might be a publication on Medium or a separate web site corresponding to In the direction of Information Science. Having a writer ensures much more folks view your article, which is important each to your motivation when writing and for sharing your data with as many individuals as doable.
Hold writing
I genuinely consider consistency is likely one of the most essential components when writing. It is best to discover a particular interval you possibly can keep over a time period. It might be as soon as a month, as soon as per week, or some other interval you like. It is best to then attempt to keep on with that schedule over time, whereas bettering one ingredient of your articles every time. Over time, you’ll discover that your articles vastly enhance, and extra persons are studying your content material.
Conclusion
On this article, I’ve mentioned methods to write technical articles. I mentioned the various kinds of technical articles you will discover on-line and the way you will discover your personal area of interest when writing. I consider writing gives huge advantages, not just for the folks studying, but additionally for the writer explaining a subject. That is additionally the rationale I’ve stored writing through the years. Lastly, I mentioned a few of my very own learnings from writing, corresponding to holding a constant writing schedule, sustaining a guidelines for every article, and discovering a writer.
👉 Comply with me on socials:
🧑💻 Get in contact
🔗 LinkedIn
🐦 X / Twitter
✍️ Medium
