Advice to novice technical writers

Advice to novice technical writers

Craig Haiss from HelpScribe published an article yesterday where 11 of the top tech comm bloggers were asked to provide advice to newbie technical writers. I was out of town last week and missed his message, what is ed so I missed my opportunity to contribute, so I decided to do it here.

My advice to new technical writers falls into the following three general categories:

  • Tools and Technology
  • Networking
  • Skill Development

Tools and Technology

As a new writer, you may not have broad experience working with lots of different tools or technologies. One of the smartest things I did at the beginning of my career was to get a minor offered at my university called “Computers in Humanities.” This minor included a survey course covering several different technologies and tools. We were introduced to web programming, .NET programming, web technologies including JavaScript and XML. I also had several classes where we learned about Dreamweaver, Photoshop, and Flash. I specifically took a class on XML. When I graduated, I had specific marketable job skills in technology areas, which led me to get my first job where I worked converting .jsp help files to an XML format. Every job I have had since then has used, in one way or another, the skills I learned in those classes. Because I had been exposed to programming, I was able to follow along (at a high level) when programmers were talking about databases and code. I understood what an array was, and wasn’t afraid to look at code samples (especially helpful when I was asked to do some SDK-style documentation).

The broader your exposure to technology and the broader your experience using tools of the trade, the better your chances are at getting hired (and being productive once you get hired.)

If you want to learn a tool you don’t know, download a trial version and go through the getting started documentation to figure out how the tools works and what it can do. Use some dummy content to create a sample project (which you can re-use from tool to tool). Then when you are looking for a job, you have real-world experience to show when a specific tool is required. Most tools have an active user base that participate in some type of community. Find that community for the tool you want to learn, and ask questions and learn as much you can about the tool. A lot of what you will learn will be transferable, even if you don’t end up using that specific tool. (For example, if you are learning about topic-based help authoring, you will be able to use that skill in several different help authoring tools. If you learn about content reuse tools in a specific HAT, chances are there will be a similar concept in a different tool, even if it is named or accessed in a different way.

A big part of a software technical writer’s job is working with technology to discover how it works and to document that for some user base. If you are uncomfortable taking a new technology out for a test drive, then tech writing might not be a good fit for you.


As in many job fields, it’s all about who you know. After my first job out of college, every other job offer has come about directly or indirectly through networking contacts I’ve had. There are lots of ways to develop your network. Start a blog and start commenting on other’s blogs with a link back to your site. Get a twitter account and tweet relevant information using standard tech comm hash tags (like #techcomm, for one example). That will help other people see your name, see your site, and possibly develop an online friendship or professional relationship with people.

I met Tom Johnson (from I’d Rather be Writing and Tech Writer Voices podcast) through our blogs. When he got ready to move to the state I live in, we wrote back and forth about issues related to that. Later, Tom had me meet him in person and we recorded a podcast regarding MadCap Flare V4. A year or so later, Tom had an opening in his organization and invited me to apply for the position, which I did. Now Tom and I are co-workers, and I had a career-advancing move that started because of an online connection I made a couple of years before.

Use the social networking tools available today to begin a network and to expand that network. If you are able to join STC, join a chapter and attend chapter meetings. Participate in STC SIG discussion groups. Gradually you’ll build a name for yourself and people will start to respect your areas of expertise.

Skill Development

This tip is related to the first one, but in this section I want to specifically talk about honing your writing skills, as opposed to the technology skills we talked about earlier.

You are (or are trying to be) a professional writer. You have a responsibility to yourself, your [future] employer, and to the profession to be a good technical communicator. You hone your writing skill by [wait for it…] WRITING. That is probably one reason why Tom Johnson (over on the HelpScribe post referenced at the beginning of this post) recommended starting a blog. On my team of five writers, at least three of them do creative writing on the side, for fun. Whatever form works for you, write. Then write again. Then write some more.

Go back to work later and look at it with a critical eye. Send your work to others you respect and ask for advice and critical analysis. D0n’t be offended when people hash up your work and want to make lots of changes to it. It’s not personal. It is work, and like you, the people you are working with are trying to help collaborate to make the best possible product.

Let me give you an example. Recently I had the opportunity to write an advertising spot script to promote a new tool that was going to be released to 30,000 customers world-wide. I wrote the first draft of the script. Over the course of several days, we met in a committee and much of what I wrote was debated and changed. If I were to focus on what everybody changed, I’d probably be pretty disappointed with the result. After all, I’m the professional writer, and “they” didn’t leave my work untouched. But that’s not how I look at it. I see the final script, and what I see is the overarching structure that I created. The original vision that I had heavily influenced the direction of the entire project, and the final product is as good as it is because I got to take part in developing it. The changes that people suggested, by-and-large, were good suggestions. They made the script stronger and tighter. I’m glad we got to work on it as a committee, because it helped me improve my writing, and it helped our customer get the best product that we could produce as a team.


If you are looking to get started in technical communication, let me welcome you to the group. We’re glad to have you. I hope that as you hone your technical and writing skills, and as you network with people in the field you will find that tech comm can be a very satisfying career. Getting started may seem daunting, but you can rely on your network to help you through, because the community wants to see you–and by extension the field of tech comm–be successful.

5 responses to “Advice to novice technical writers”

  1. My name is Nitika and I am a Technical Writer by choice. I have been working since 3.5 years in this field and I am very happy…….. 
    If I go back from where I start, I had a very interesting career path.
    I started my career from the BPO sector, and then started working in a NGO as a content writer, while working in NGO my sister suggested me to search about Technical Writing field. After doing a lot of research I was convinced about this field and did a course in Technical Writing from Bangalore.
    Soon after completing my course I got a job in a finance sector in Gurgaon as a Technical Writer and came across many new opportunities. Suddenly I got a big twist in my and that was “MY Marriage”. I shifted to Bangalore and currently working in a Telecom Company.
    This was a small snapshot of my interesting career path.
    I am satisfied with the work I am doing and always try to look for the next new development in this field.
    But fine one day someone asked me a very simple question, which was, “What is the career growth in Technical Writing?” I explained him the profile but somehow, I was not very confident with the answer I gave. And since then, I am searching for the correct answer. Someone suggested that I should go for further studies like:
    • Doing a course in Quality Management
    • Doing a Master’s degree in Technical Writing
    • Doing a course in Technical Communication and etc.
    My search is still on but I am not able to find my answers…
    Now, I really want to do some further studies in my field and want to move ahead, but I am not getting the right path and I don’t know, “Which direction to go?”
    I really need suggestions from the people who have explored all the different opportunities related to Technical Writing and have achieved success.

  2. Hi Nitika,
    I will shortly get back to you for sharing my experiences as aTechnical Writer.
    Have a great Learning!

Leave a Reply