Writing and Editing

New Services: Grant Writing

grants-writing

We are adding grant writing to our services. We have some experience but we are new to this field. However, our inexperience is your gain because our price is going to be kept low until we get the experience. Plus, we only get paid if you receive the grant. It’s a win win situation for you.

We looking forward to working with you to help your organization succeed in its goals.

Editing isn’t important….right? by Melinda Anderson

I have just spent three hours helping my husband to study for a General Painting Contractors License to cover certain states in the midwest. The experience has been highly entertaining and informative. In fact, it has been so entertaining that I have chosen to share a few of the questions from the practice tests he has been studying. Let’s start with something very basic such as extra words.

“What should aluminum be wiped with what after weathering?”

Now, you might have quickly read this question and your eyes may have stumbled but you got the gist of the question. You might have even read it agin just to make sure. However, let’s pretend for five minutes that you have a reading disability. You might read this question like this:

“What should aluminum be wiped with what? After weathering.

Now, don’t get me wrong, I have made several errors just like this one. Writing is not perfect, however, the author of this question could have taken at least 5 seconds to read the question thereby discovering the extra word.

Most of the questions are the standard multiple choice with one or two answers. This next example is confusing because the sentence has blank spaces for two answers but only one is needed.

“A HEPA sanding abatement method removes _____________ and _________________ coating.”

( ) lead based
( ) epoxy based
( ) primer based
( ) none of the above”

I read this and I automatically assumed that two answers are needed because there are two blank spaces. I quickly scanned my choices looking for one with two answers. I expected something like ( ) lead and epoxy based or ( ) both 1 and 2.  As you can see, there is not a selection with two answers. I reread the question and looked at the answers again. I quickly realized that someone had made a mistake and no one had caught it.

I don’t want this post to be longer than necessary so let me sum up the rest of the errors really quick, missing articles, misused prepositions, conflicting information, and misused punctuation. These are just the common errors that I, a lowly technical writer, discovered in three hours while helping my husband study.

These materials are supposed to be designed to help a student learn. However, errors like these only confuse a student and make the learning process even more difficult.

I guess whoever wrote these materials did not consider the student’s need. After all, why bother editing if you don’t care about your audience.

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

Hit and Miss; Our Marketing Flier Mistake

When we first started this business, we printed up fliers to hand out to potential customers and clients. We created something quick and did not revisit it until almost six months later. Here is the original, keep in mind it is two fliers on one page, DragonTechone page flier

It has all the pertinent information such as business name, services, blog address, names, contact information, etc. However, it is a jumbled mess. There is no organization for a reader’s eyes to follow. There was no thought what so ever put into this flier; other then to get our name out quickly. This is a mistake that most businesses make, including ours.

Anything that has your businesses name, logo, or information needs to be carefully planned, discussed, and executed to make sure that it reflects your business and the audience you are targeting. It could be as simple as a flier or as complex as a website. The point is you have about 3 seconds to catch your audience’s attention before they move on to the next business.

This flier is part of our marketing campaign to introduce us to professionals and businesses that may need our services and it does not show who we are or the services that we offer. We quickly came up with a layout and design that reflected what we could do for other professionals and businesses. Here is the new flier, still two fliers on one page, DragonTech Writing, Flier. Can you spot the differences?

This flier has the exact same information as the first with some tweaks. It catches the eye and is organized for our audience to scan it quickly. Our business name and logo are now separated from the information by stylistic elements. Okay, it is just a line but it still allows a reader to zoom in on the business name. The second line lets the audience know that they are done reading. It also tells us where to cut the flier so we don’t accidentally cut out information.

This is the flier we should have started with to market our company. This is what we can do for you or your company, point out the flaws in your documentation then create a design and templates that represent your business accurately.

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.

i or I, that is the question..

I am currently formatting my poetry book and believe me it hasn’t been easy. I tried to do everything on computer but it just wasn’t working. Finally, I put the poems that I want to publish in one .pdf and printed it. I took all 50 some odd pages with me when my husband and I left to cook dinner at our local Elks Lodge.  Okay, he cooked and I was supposed to be the waitress.

However, not very many people showed up to eat dinner so I was able to arrange my poetry book. There were a few people who asked if they could read some of poems and I gladly let them. Everyone who read them seemed to enjoy them. I did get one comment about the i that I use stylistically versus the I that is proper grammar. I know that the I is proper grammar, I use it every day, in everything I write including text messages; much to my kids annoyance.

My poetry is not proper grammar never has been and never will because it is poetry not grammar. Poetry produces an image or a feeling in the mind of the reader and does not have a specific set of rules, grammar or other wise, governing it. For instance, take this poem that I wrote years ago:

You
sighing soft caress
gently whispered words
tender holding arms
soul burning passion
gazing long looks
sweet loving surrender
moonlit perfumed walks
sensuous silk
erotic love

I have been told that this poem is depressing and I can not figure out why. To me, the author, it is about love and how you feel when you are in love. I have reread it over and over again and I still do not understand how anyone could view this as depressing. It is a matter of perspective just like the i versus I in poetry is a matter of style.

My point is this, I know that if I sent a manuscript in to a publishing company with an i, I would get turned down. The little i, in my poetry, is my way of rebelling against the good grammar I use in my professional and personal life. It is part of my style and I am not going to change it just to get published. This is why I have chosen to self publish my poetry book and avoid the issue altogether.

By Melinda Anderson
reprinted from http://me1an.wordpress.com/