Technical writer

Why Was Dragon Tech Writing Created?

There are several various different stories that led to the creation of Dragon Tech Writing but I will stick with the most recent. After I graduated in 2009, I could not find a job in my field locally. I had no desire to uproot my family and start over in another bigger city where I could have had a job. Talk about claustrophobia. After two years, I was finally able to get a job at YESCO Electronics that I loved.

It was a great position with people that I enjoyed working with, even with all the ups and downs. Unfortunately, they were having some growing pains. I made it past the first cut but not the second cut. After 2 years, I was back in the job market with a little experience and realized that the technical communication field, unless you were in a major city, was dying.

Business were focused on surviving the new economic down slide and not on growth or improvement. If they were hiring technical writers or communicators, it was part time, temporary, or contract based. While talking with my husband, I burst out and said, “Maybe, I should just start a technical writing business.”  He said, “Maybe you should.” I realized that I would not be able to create this company on my own.

I am in a stitching group that meets once a week at Embroidery Central. Carrie also attends and her husband is also a technical writer so I approached her with the idea. She talked to her husband and she arranged for us to met. We both liked each other immediately and we decided to start this business.

A year has passed and we have had one client, thank you Cirra Systems. Whenever we introduce ourselves we are constantly asked, “What is technical writing?” We are the faces of our business but it also seems we are the faces of our chosen field. We are still defining our business and its role in our community but I guarantee you, we are having a lot of fun.

by Melinda Anderson

DITA

A Technical Writer has to stay up to date on the latest publishing software and trends within our field. We also have to be able to explain those software or trends to our employers or clients. I started to read about DITA about three years ago and I did not pay much attention. I was hired by YESCO Electronics as a technical writer. Their software choice was Adobe InDesign with their publishing choice being PDF. I was okay with this until I started documenting several different types of documentation that consisently required updating.

I started to read more about DITA and how efficient it could be. I tried to find a way to pitch DITA to the company. However, I could not find an article that really delved into the why should I care as a technical writer or why my employer should care; until now. “Why Should I Care About Dita? by Jacquie Samuals, published by TechWhirl, explains why technical writers should care about DITA. It also has some pointers to bring to management that would make any team look into DITA such as consistency and quality.

If you are a technical writer or a student in this field, I highly recommend that you read this article.

PDF, RTF, TXT, DOC, DOCW…. Which file extension do I use?

There are several different word processors out there, each has advantages and disadvantages. They  each use different file tags and will access some of the universal tags differently. This is another area that Technical
Writers should be familiar with in order to survive.

A company will likely send a draft of what they want converted/translated/polished in a format using their preferred word processor. Yes, Word is popular, but there are still diehard Open Office, Wordperfect, and other word processor users out there and the extension (the three letters behind the dot that follows the file name) will be different for each.

Many word processors will convert files from other word processors to their format but the results may or may not be acceptable. PDF is another extension that is universal but typically information is lost and it is difficult to edit a PDF file.

There are two solutions to this dilemma. First, make sure that you have a working copy of every word processor used by any customer. This is the best solution but obviously this is impractical for most writers. The next best solution is to request that customers send files with a .rtf extension. Most word processors have a save as function and will allow users to send files with an RTF extension. The advantage is that RTF files can be opened by most other word processors. They can also be easily edited and saved into the same format without losing graphics and other information.

By Neil Dabb

The Changing Face of Technical Writing:

At a recent job fair, one of the recruiters said something to the effect, “They don’t have those any more do they?”  Many of the vendors at the fair were looking for engineers and other technical professionals, but I did find several firms looking for technical writers, many on a contract basis.

The question is, Is the field of technical writing going away?  The answer is no, unless, engineers and other technical professionals learn to use language that clients and customers can understand and are willing to write the marketing and training materials that go with the procedures and products they produce.  However, the technical writing field is changing.

I was recently reading a blog that was discussing changing the title of Technical Writing to something more current.  The problem is, while the field of technical writing is expanding, attempts to change the title would only give upper management an excuse to lower the  wages and professionalism of our field; not too mention create confusion among the field itself and emplyers.  Currently, many firms are eliminating their full time technical writers and hiring contract technical writers or temporary technical writers as the need for documentation arises.

These new developments make work in the field of Technical Writing a different creature.  There are challenges, but there are also opportunities to expand the field as well.  The face of Technical Writing is changing.

DragonTech Writing, championing the cause for technical writers.

By Neil Dabb

Technical Writing Defined

Here’s a definition of technical writing that I am going to use as part of a conference presentation:

A broad definition of technical writing: Any non-fiction writing of a technical or business nature. Sub-groups may include: Computer software and hardware documentation, process documentation, training materials, presentation materials, marketing materials, HR manuals, business plans, resumes and cover letters, engineering documents etc. A technical writer also translates technical jargon into English the rest of us can understand.

Alternate titles for a technical writer may include, copy writer, report specialist, documentation specialist.

Neil Dabb

Revised Mission Statement

I met with my partner, Neil, and we revisited the mission statement that I had created. This is what I had created:

DragonTech Writing is a contract technical writing service that provides documentation in the following areas software, process, business, marketing, and portfolios (resumes/cover letters) for companies and individuals. Our mission is to provide companies and individuals with documents that are clear, concise, and useable for their customers, clients, or perspective employers.

While he did like it, he felt that it could be stronger. Keep in mind that he has experience writing mission statements for non-profit organizations.

Our mission is to provide local businesses, individuals, and entrepreneurs with clear and concise business documents (such as resumes, cover-letters, business and marketing plans, instruction and operations manuals, portfolios, etc.) as well as instructions on how to use those documents. We will also aid businesses in documenting processes, hardware, and software.

What he did is he put the people and places that we are targeting first; whereas, I put the types of document first. Basically, that is our market people or businesses who need help with documentation. Our market is not documents, they are not going to make conscious decisions to hire us.

He then stated that we will provide these companies with clear and concise business documents and created a list in parenthesis that clearly shows what we offer. We offer a wide range of services that will continue to grow as our business develops. The parenthesis state here is what we have so far but we are not limiting ourselves and we will offer instructions for the use of these documents if needed.

I will admit I was upset at first; its that ego thing that gets in the way from time to time. In the end, I quickly realized that his mission statement wasn’t better than mine. They both state the exact same thing but his is stronger and targeted for our market.

Mission Statement

I am starting to write the company goals for DragonTech Writing and have realized that we need a mission statement also known as a 60 second commercial. This statement needs to say who we are, what we offer, and tie into our company goals. Here is my first attempt at a mission statement:

DragonTech Writing is a contract technical writing service that provides documentation in the following areas software, process, business, marketing, and portfolios (resumes/cover letters) for companies and individuals. Our mission is to provide companies and individuals with documents that are clear, concise, and useable for their customers, clients, or perspective employers.

I think that sums it up for now. I am sure there is something I can add or take away, any thoughts?

By

Melinda Anderson

Marketing

I just finished a free slide show called Marketing 101: The Fundamentals by SBDC Kutztown University of Pennsylvania. It had a lot of information that seems extremely useful; especially, since I am going to run the marketing side of the business. However, it had information that I just didn’t understand and probably won’t until I actually start working on our marketing plan.

A marketing plan says this is our product or service, this is how much we charge for our product or service, this is our target audience, this is how we are going to reach our target audience, this is how much we are going to spend to reach our target audience. For example, My husband, Jason, has started a painting company with his friend, Darin, A & M Coatings. Their service is painting and or staining walls, floors, ceilings, etc. Their basic fee is  $2.20 a square foot. Their target audience is business owners, contractors, and home owners. They spent maybe a total of $20 to print out business cards from home. They then drove around, looked for buildings that were being built, and talked to the contractors or business owner’s. After about one week, they put in about 10 different bids and got 6 of them.

My partner, Neil, has talked to people at various different career fairs. We have our business cards and flyers that we hand out to anyone and everyone. We have a blog page and a Facebook page. We are both on Linked In and members of various different groups. We also do not have any work coming in.

The slide show mentioned taking doing polls and surveys to find out what consumers want or need in regards to your business, products, or services. Both of us, Neil and myself, are technical writers. Neil specializes in process documentation and instructional design. I specialize in documenting software, writing service bulletins, and creating layouts. We are also adding services such as business plans and resumes just to kinda give us a kick start. Here’s the question, anyone can answer, what kind of marketing ads or promotions would like to see from us?

Resumes

A technical writer can take your resume and find a layout to make it pop.  A resume is more than black and white text listing your achievements, education, skills, experience, and technologies. A resume is a marketing tool for any individual looking for a job.

No one is going to take the time to read a resume that is three pages long. No one is going to read a resume that is text heavy.  No one is going to read an unorganized resume.  For example, look at this fictional resume for Ashkevron, Harry (Fictional Resume Original). This resume and others like it will be tossed into the garbage without a second glance.

One job can receive hundreds of application from around the world. Ashkevron’s resume has all of the necessary information that a university would look for in candidates. However, that information is buried and hard to find. The visual clues are confusing and direct your eye down the side of the page skipping over the text that shows his experience.

A resume is like a 10 second commercial. It has to catch your eye, show your skills, and demonstrate your experience while at the same time evoking excitement in the hiring manager. They have to believe that you are the perfect fit for their company. Ashkevron asked a technical writer for help and here is the result Ashkevron, Harry (Fictional Resume).

This resume is only one page and it is scan able. It has visual clues such as font styles, bullets, color, and white space that invite the eye to read the text. This resume now stands out and will get attention instead of landing in the garbage.