DEV Community

Cover image for Tackling Technical Writing

Tackling Technical Writing

Alaina Kafkes on August 18, 2017

I recently received a request from a reader for technical writing advice. As I sat down to respond, I thought back to something I heard Scott Han...
Collapse
 
damcosset profile image
Damien Cosset

Great tips. To me, the best thing about blogging is how much I remember the things I learn when I write about them. Having to dig deeper, having clear thoughts, explaining to someone else. I guess it has the same effect than the rubber duck debugging technique. Such a game changer. Everyone should blog.

Collapse
 
ben profile image
Ben Halpern

Great post Alaina. I'll also add that I find it helps to think that you are writing one person to consume. That helps get you over the hump of uncertainty of how the world will take it.

Collapse
 
fribenyah profile image
Friben Yah

Great article that you wrote.It's good to know that you merged into the technical writing scene with great ease and have seen a return on your work.My only question about technical writing is does it have to be thousands of words long to be considered technical?

Collapse
 
alainakafkes profile image
Alaina Kafkes • Edited

Thank you, Friben! No, the length of the post does not matter. What determines the length of my technical writing posts is how many words I need to explain a concept fully. 😀

Collapse
 
kayis profile image
K

Sounds good!

Especially the "how YOU solved it" part.

This is a problem with sooo many writings.

People did one thing, maybe two and now tell you what general idea they extracted by induction.