DEV Community

Writing a Technical Blog

Abbey Perini on December 01, 2022

I wrote about how I structure my writing in general last November, as part of the 14,584 words I wrote for Virtual Coffee's blogging monthly challe...

Read full post

Joseph Taiwo • Dec 6 '22

Just started writing recently, and I can relate to the one were you leave your article for a while and come back later, it usually feels to me like I am reading and essay I wrote when I was 10 😅

I have had problems writing references though, I find it easier to write guides and documentation, also wondering if you could whip up something to help with writing references. Thank you

Abbey Perini • Dec 6 '22

🤔 I'll have to think on that one. I learned by writing research papers and having to cite my sources.

I would love to share the note card method my middle school science teacher taught me, but I'd have to apply it to online resources and give a digital format. 🤓

Joseph Taiwo • Dec 6 '22

Nice, can't wait

Found some really good articles on your blog, I will go consume those while I await 🙂

Abbey Perini • Feb 7 '23

Just in case the tag didn't work, here's the blog post response to this.

Vijay Singh Khatri • Dec 6 '22

@abbey This is an awesome writeup; even after contributing so long feels like something I missed that I am used to.

Thanks for sharing your quick insights about how one should start their content writing journey especially in Tech Domain.

Comment hidden by post author - thread only accessible via permalink

Vijay Singh Khatri • Dec 7 '22

Here are some tips to help you write a great technical article:

Start by choosing a specific topic that you have expertise in that is relevant to your audience. This will help you focus your article and make it more useful and interesting to your readers.
Research your topic thoroughly to ensure that you have a deep understanding of the subject. This will help you provide accurate and up-to-date information in your article.
Use clear and concise language to explain technical concepts in a way that is easy to understand. Avoid using jargon or complex terminology that may be confusing to your readers.
Organize your article in a logical and easy-to-follow structure. This will help your readers understand and retain the information you are presenting.
Use examples and visuals to help illustrate your points and make your article more engaging. This can include diagrams, charts, graphs, and other visual aids.
Proofread your article carefully to ensure it is free of errors and mistakes. This will help you avoid any confusion or misunderstandings that may arise from incorrect information.

Joshua Slate • Dec 1 '22

Thank you, Abbey. I just decided to start up a blog again after many years, and these are some great tips. I particularly like the one about letting things sit for a day or two before hitting the publish button. It's bad for instant gratification, but great for finding mistakes and clearer ways of wording things. It's certainly been interesting coming back to longer-form writing after not having to write much more than an email-length piece since college 😅

Jean-Michel 🕵🏻‍♂️ Fayard • Dec 1 '22

Also it's much less stress than trying to make everything right so that you can finally press publish.

Nneka Onochie • Jan 15 '23

This is a very insightful piece because I want to start blogging.
I learned some vital skills that will guide me through the starting process. Thank you for letting this out.

Borzoo Moazami • Dec 7 '22

Thanks Abbey for sharing, inspiring post.

Marcelo Arias • Dec 6 '22

Thank you for the tips Abbey! ☺️

Kevin Tewouda • Dec 7 '22

Hi Abbey, nice article. However I don't understand the difference between a guide and a reference. Could you give me examples in both categories so I can see the difference? Thanks

Abbey Perini • Dec 7 '22

Guide

Reference

Kevin Tewouda • Dec 8 '22

Thanks, it is now clear for me

Some comments have been hidden by the post's author - find out more