Welcome to Technical Writing


© John L. Hoh, Jr.
Articles in this Topic    Discussions in this Topic

My name is Vicki M. Taylor and I've been a technical writer for about fifteen years.

I became interested in computers while in the US Marines. A few years after I left them, I went back to school and got my degree in Computer Science. I then became a programmer but wasn't as happy as I thought I would be in that career choice. I realized that I wanted to work more with people and learn about the entire project rather than just the piece I was coding.

I have always liked to write and I am a very organized person. All of these traits are great for tech writing. I started as an entry-level tech writer and worked my way up through the various levels until the last four years I managed a couple of documentation departments. Two years ago I became incorporated. I now have a consulting firm that does Technical writing for other companies.

We document computer software applications for companies who either create the software applications in house or purchase them and wanted additional documentation. They may want additional documentation for training purposes, or they may have felt that the existing documentation was inadequate.

We provide documentation in the form of user manuals, on-line help, reference guides, quick start guides, etc. We also document business processes to help companies identify their process flow. This also helps provide internal training documentation for their employees. The software applications that we document can be run on a mainframe, PC, or midrange computer and written using a variety of word processing, desktop publishing, or help authoring tools.

For example, I use Microsoft Word 97 for most documentation tasks. If the company wants a full manual design, with several colors, pictures, etc. I would use PageMaker or FrameMaker.

For on-line help authoring there are a lot of choices, but I prefer RoboHelp for strictly on-line help. If I were asked to create on-line help, a user manual, and possible text for the company's website, I would use SolutionSoft's HelpBreeze because it lets me create one file that can be used to do all the different documentation tasks.

I've been asked many times about the stresses and rewards of a Technical Writer.

The biggest headaches (i.e, anxieties and stresses) are project schedules! Documentation seems to usually be an afterthought for most companies. As a technical writer, we're always playing "catch-up" with the programmers. They're schedules run over, but the deadline never changes. So, as a writer, we're given less time than ever to create the documentation. In the "perfect world", the first draft of a user manuals should be finished at the same time as when the software is sent to Quality Assurance for testing. That rarely ever happens. There have been times I've actually documented an entire system, from a design document and notes from a programmer. I NEVER saw the product working. The programmer then used my documentation to write the system.

Go To Page: 1 2


Post this Article to facebook Add this Article to del.icio.us! Digg this Article furl this Article Add this Article to Reddit Add this Article to Technorati Add this Article to Newsvine Add this Article to Windows Live Add this Article to Yahoo Add this Article to StumbleUpon Add this Article to BlinkLists Add this Article to Spurl Add this Article to Google Add this Article to Ask Add this Article to Squidoo


Here's the follow-up discussion on this article: View all related messages

12.   Nov 1, 2000 7:49 AM
In response to message posted by jerrib:

Hi Jerri, Thanks for the welcome. I appreciate your thoughts. I'm hoping that I can ...


-- posted by VMTWriter


11.   Oct 21, 2000 9:58 AM
I did a lot of technical writing for the State of WA. There's a lot of work out there, and I'm sure you'll be a great help to folks wanting to get into the industry or expand their writing gigs. You ...

-- posted by jerrib


10.   Sep 13, 2000 8:31 AM
Allison, Sandra,

Thank you for your welcoming words. I really do appreciate them.

Thank you for the Themestream/Suite101 crossover link. I've already modified my page to include it.

Sandra, I ...


-- posted by VMTWriter


9.   Sep 13, 2000 7:51 AM
I plan to visit often since I would like to add more technical writing projects to my editorial services business (I'm trying that moniker rather than freelance writer to see if it makes a difference) ...

-- posted by SandraLinville


8.   Sep 12, 2000 10:02 PM
I'm a web designer and creative writer, but found your article of interest. I hope you enjoy being a Contributing Editor for Suite101. It's a wonderful community! ...

-- posted by ahunter





Join the latest discussions

For a complete listing of article comments, questions, and other discussions related to John L. Hoh, Jr.'s Technical Writing topic, please visit the Discussions page.