, 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 personal area of interest, and what it is advisable to keep in mind when writing an article.
The objective of this text is to show about technical writing and the various kinds of technical articles. Moreover, I’ll talk about the big advantages I’ve had from writing and a few classes I’ve realized from my writing.
You can too 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 among the finest choices I’ve made up to now 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 whole lot 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’ve got sufficient readers, writing can also be a method of economically supporting your self, although I preface that this shouldn’t be your main motivation to start out writing.
I imagine the primary level on studying subjects outweighs another profit I’ve had from writing. Writing supplies 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 best 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 way of writing about it. I actually reckon this to be one of many best elements of training technical writing, and a major motive I like to recommend that you just additionally write technical articles.
Forms of technical articles
- “Easy methods to …” programming articles
- Testing/reporting on new releases
- Educate a couple of subject
“Easy methods to” articles
A how-to article is an article detailing the right way to do one thing inside programming. It might be as particular as the right way to make the most of a specific Python bundle, or as imprecise as the right way to use context engineering. These are the sorts of articles I favor 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 undertaking, or study a subject (for instance, 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 inside the subject.
Testing new releases
A number of technical articles additionally deal with 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 prime 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 couple of subject
One other frequent technical article is one educating a couple of particular subject. These articles often 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 knowledgeable readers, or something in between. I often learn such articles when stepping into a brand new subject, or to remain on prime of subjects I’m notably fascinated with. You must observe that these articles are sometimes very time-consuming to make, however they typically symbolize a number of the highest-quality articles I learn on-line.
Discovering your area of interest
When writing, it’s important to search 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 may solid a wider internet, comparable to “How-to” tutorials for AI.
To search out your personal area of interest, I like to recommend you strive writing the completely different article sorts I listed within the final part. A very powerful side is to search out one thing you get pleasure from writing about. This could, after all, additionally change over time. After discovering what you get pleasure from writing about, it is advisable to begin writing articles often. I write round as soon as every week, which I feel is an efficient steadiness between persistently sharing my data on-line, whereas additionally avoiding inventive burnout by writing too typically.
Moreover, I additionally discover that it’s often 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 whole lot of background data, which is helpful for the article, and supplies me with inspiration for subjects to write down about.
My learnings
Enhancements for every article
I’ve realized rather a lot by way of writing for two.5 years. I see huge enhancements between my first article and my present articles. My objective has at all times been to attempt to enhance one thing particular for every article. This fashion, 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.
Listing of concepts
The concepts for my article often come from subjects I work on, in addition to studying LinkedIn, X, and Medium. I then study extra in regards to 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 preserving a listing of various concepts you need to write about. I hold this record in Google Maintain, so I can entry it each through 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 easier than having to give you 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 pink thread within the article. You possibly can naturally add or take away headlines afterward, 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 need to confer with). In that case, I write “TODO to search out the article to confer 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 fashion, 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 you can too keep in mind every thing it is advisable to do, utilizing the TODOs.
Guidelines
One other necessary studying I made is to take care of a guidelines of every thing it is advisable to do for every article. There are a whole lot of various things it is advisable to 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 examine
- Guarantee all code within the article has syntax highlighting
- Share the publish on LinkedIn and X
- …
Writer
I additionally extremely advocate discovering a writer to your articles. This might be a publication on Medium or a separate web site comparable 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.
Maintain writing
I genuinely imagine consistency is among the most necessary elements when writing. You must discover a particular interval you’ll be able to keep over a time period. It might be as soon as a month, as soon as every week, or another interval you like. You must then attempt to keep on with that schedule over time, whereas enhancing one ingredient of your articles every time. Over time, you’ll discover that your articles vastly enhance, and extra individuals 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’ll find on-line and the way you’ll find your personal area of interest when writing. I imagine writing supplies huge advantages, not just for the folks studying, but in addition for the writer explaining a subject. That is additionally the rationale I’ve stored 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 contact
🔗 LinkedIn
🐦 X / Twitter
✍️ Medium
