DEV Community

Cover image for Writing a technical article/blog 101 ✍

Writing a technical article/blog 101 ✍

Vaibhav Khulbe on March 03, 2020

Shoutout to @tringakrasniqi who inspired me to write this article. 😊 I've been writing technical blogs for quite some time now. Over these years, ...
Collapse
 
dponrails profile image
David Patrick

Nice Article! Anyone in search of technical details in writing, Google has a great source they use for their engineers developers.google.com/tech-writing

Collapse
 
dhruvgarg79 profile image
Dhruv garg

Thanks, David. I was looking for something like this.

Collapse
 
vaibhavkhulbe profile image
Vaibhav Khulbe

Thanks for the link David!

Collapse
 
sshine profile image
Simon Shine • Edited

As someone who is familiar with writing but new to blogging, the following tips were new to me: ask for feedback, and use a cover image. I will ask for feedback in my next post, which will be about some software that I release, so it should be perfect.

I'm still not convinced how to pick a cover image; I could pick random art from my artist friends to simply promote it. Considering that I aim for cover images to hold no other information value, that is probably what I'll do. Thanks for motivating the thought. :-)

On the subject of composition one could elaborate even more; I like to think of online "short-form" reading like downloading JPEGs on a modem where you get gradually finer pixelation:

  • The title: You can only really specify the domain.
  • The caption ("tl;dr: ..."): You can summarize your findings in one short sentence.
  • The first paragraph: You can summarize the most important part of your findings in 3-4 short lines.
  • The rest of the article should proceed in a similar fashion. How "beginning, middle and end" work is covered better elsewhere.

At any point, the reader will quit. Give them as much as you can with as little as possible. This style of writing is not "long-form" as demonstrated e.g. by VICE and has its limitations. But I would rather always keep reading to at most 5 minutes. This blog post of yours says 5 minutes, too.

Collapse
 
vaibhavkhulbe profile image
Vaibhav Khulbe

Great points here! Thanks for this comment :)

Collapse
 
manuelosorio profile image
Manuel Osorio • Edited

This is a great article and the discussions on here are also very insightful. I was looking up information on technical writing because I this is something I want to start doing soon, as a way to share what I've been learning especially for problems that took lots of research, such as reading documentation or forums threads, to find a solution that works. In the case of forum threads I usually find conversations that lead me to a solution of my own.

Collapse
 
vaibhavkhulbe profile image
Vaibhav Khulbe

Thanks for reading @manuelosorio ! :)

Collapse
 
binyamin profile image
Binyamin Green

Question for you: How does one get ideas for articles?

Collapse
 
aleksandrhovhannisyan profile image
Aleksandr Hovhannisyan
  1. Monitoring StackOverflow and tech sites regularly, including Medium, Dev.to, Hacker News, CSS Tricks, and other sources.

  2. When you solve a problem that you were running into frequently, and you realize that few people, if any, have actually shared that solution with others.

I'm sure there are more ways than just these two, though.

Collapse
 
vaibhavkhulbe profile image
Vaibhav Khulbe

Awesome GIF

Collapse
 
vaibhavkhulbe profile image
Vaibhav Khulbe • Edited

Great question Binyamin! Here are a few points regarding the same:

  1. Ask yourself. What do you want to share with the world? Any tip? A tutorial? A new tech stack you learned? Some cons or pros of a language? There can be thousands of such ideas at your disposal once you start asking yourself!

  2. Interact with others. The more you communicate (both online/offline), the more knowledge you gain and the more ideas your brain creates!

  3. Hop into trends! Google has it's own Trends website, pick a topic and share the knowledge.

  4. Join communities. This helps in getting more buzzwords and tech words/skills which you may want to discover and then write about it.

  5. Follow Aleksandr's points!

Collapse
 
binyamin profile image
Binyamin Green

This is one of those moments where I wish I could save comments on DEV!
@ben nudge nudge

Thread Thread
 
vaibhavkhulbe profile image
Vaibhav Khulbe

Emotional GIF

Collapse
 
bgauryy profile image
bgauryy

Also,
Ask for review before publishing technical stuff, but don't let othes change your "voice".

Collapse
 
vaibhavkhulbe profile image
Vaibhav Khulbe

Correct GIF

Collapse
 
momin profile image
Md Abdul Momin

I'm searching for tips and guidelines to write technical articles, fortunately, I found your post, and I hope it will help me a lot!

Collapse
 
vaibhavkhulbe profile image
Vaibhav Khulbe

Thank you and good luck!

Collapse
 
dhruvgarg79 profile image
Dhruv garg

Very helpful article and the discussion on this post is amazing. This will certainly help me.

Collapse
 
vaibhavkhulbe profile image
Vaibhav Khulbe

Thank you for being my reader. 🤗

Collapse
 
antoine_m profile image
Antoine Mesnil

Really clear, nice post. You said you moved to DEV from Medium, did you consider to crosspost ? I'm curious about your choice :)

Collapse
 
vaibhavkhulbe profile image
Vaibhav Khulbe
Collapse
 
remrkabledev profile image
Malcolm R. Kente

Some really good tips here! Thanks for sharing this 👍

Collapse
 
vaibhavkhulbe profile image
Vaibhav Khulbe

I'm glad you found it good. 😀

Collapse
 
shaijut profile image
Shaiju T

Technical articles are not here to teach Oxford English. 😄 But it should make us write Good and better English.

Collapse
 
vaibhavkhulbe profile image
Vaibhav Khulbe

Agree!

Collapse
 
tringakrasniqi profile image
Tringa Krasniqi

Great article!! It is so great to find advice on how to write quality technical posts. I am sure these tips will help anyone trying to get better at writing (including me :)) Good work!

Collapse
 
vaibhavkhulbe profile image
Vaibhav Khulbe

💯% yes! Do you have other questions to ask? 😛

Thanks GIF

Collapse
 
binyamin profile image
Binyamin Green

That was a very well written article with some excellent tips. Thank You!

Collapse
 
vaibhavkhulbe profile image
Vaibhav Khulbe

Welcome GIF

Collapse
 
timrodz profile image
Juan Alejandro Morais

Thanks for this great article, Vaibhav. It will definitely help me, and many others, in their writing journey.

All the best! :)

Collapse
 
vaibhavkhulbe profile image
Vaibhav Khulbe

So good to hear that it will help you. And thanks! :)