Posts Tagged ‘tips’

New Technical Writer: Avoiding The Interview-writing Disconnect

April 17, 2009 - 9:21 am

OVERVIEW

Lost or garbled information is a terrible waste. Especially if it’s the information you gathered from an interview and must now write into your User Document. Here’s how to prevent that waste.

THE SITUATION

You had an interview with a Subject Matter Expert (SME, someone who has the information that you need) for your product. He/she told you all that you needed to know. However, by the time you got to write the material into the User Document, you have forgotten much of what was discussed. Your notes only help a bit. This loss or garbling the information from the SME that you need for your writing is the “Interview-Writing Disconnect.”

SOLUTION

The solution is divided into three components: Preparation Before the Interview, Actions During, and Following the Interview.

TIP: If possible, schedule the interview as close to the time that you are going to write that part of the User Document. The longer you wait between the interview and the writing, the more difficult it will be to recall the content.

Before the Interview

* Your guiding principle is to Be Prepared. You should have read what you can about the product, its environment, who will use it, and what they (usually) want to do with the product.

Know as much as you can before the interview. The more you know about the product, the better off you will be in the interview.

* Specify the goals of the interview. Share this information with the SME. Do this in an e-mail before the interview.

* Ask the SME if you can (audio; video is too obtrusive) record the interview. Get a recorder (preferably a digital recorder) and make sure it is set up to function properly during the interview.

* Gather any other materials you will need for the interview.

* Set up your recorder, etc quickly when the meeting begins.

* (You might want to practice taking legible notes…I sure need to)

THE HARDEST PART

Leave your ego at the door. (This is really hard.) Don’t make signs that indicate that you understand something that you do not. Ask questions, get the explanation that you need. Here is something to tell the SME:

“If I ask what sounds like a stupid question, bear in mind that I am acting based on the knowledge that our User has.”

DURING THE INTERVIEW

Record the interview (if permitted).

Start with some overview questions, such as:

* What is this portion of the product (topic) called?

* How does this topic fit in to the product?

* What is this (portion of the product) used for?

* When would someone use this (unless it is “obvious”)?

* What has to be set up before the User can use this part of the product?

* Any other conditions about when this would be used, or when it would be avoided?

After you have the background information, then move on to the actual operation of the part of the product. Ask any questions that you have prepared and any others that come up in the interview.

Remember, if you do not understand something, ask.

Ask some summary questions. Review the steps that you took, saying them out loud in your own words (especially if you are recording the session). Have the SME correct any mistakes that you make.

Ask if there is any related information to this topic. Are there any tips or traps using this part of the product?

MORE ABOUT RECORDING INFORMATION

If the SME points to a part of the product (such as a window in a piece of software, or the control panel of a barbecue) then say out loud what the SME is pointing to. Say something like “we are looking at the main address book window” or “we are looking at the main burner control.” This will enable you to link what is happening in the interview with the audio tape.

If the SME performs an operation, say what it is. “You just entered the new person’s name, and the ‘New Card’ window appeared.” Or “You just turned the burner control to the ‘Light’ position, and now the igniter is clicking, and there’s the flame.”

Take notes as well as you can. But do not let any of your activity get in the way of the interview. It’s not a good idea to keep stopping the SME while you catch up with your note taking. You will have the audio recording to fall back on.

The SME might provide handouts for the interview. If you are allowed to, take notes on the handouts. The goal is to link your audio recording and notes and handouts together. For example, if the SME provides a screen print for a software product, you should link your notes, audio recording and the handout together by reading the title of the handout aloud. Do it as unobtrusively as possible.

AFTER THE INTERVIEW

As soon as possible after the interview, you must go over your notes and handouts. If possible, this should be done within minutes of the end of the interview. Find a quiet place (perhaps you have access to the interview room after the interview) and go over your notes.

Review your notes and add clarification to them. When you add the material to the notes do it with enough detail so that someone who was not at the meeting will be able to understand it. That person is you in even a day or two!

As soon as you can get to it, take the expanded notes and write them into a draft of that part of the User Document. That should be within a day or two of the interview, if possible. Every minute’s delay adds to the disconnect between what you learned in the meeting and what you write.

Let your draft sit for a day or so, then review and revise it for clarity and completeness. Consider sending the reviewed and revised version of the draft to the SME for comments. (You only want comments on the material, not on grammar.)

Schedule time for this writing, even if you are juggling several writing projects. The time you save in not having to recall the information at a later date will be a good investment.

THE BOTTOM LINE

You can avoid or reduce the effects of the Interview-Writing Disconnect by being prepared before the interview, asking questions and taking effective notes during the interview, and reviewing and writing the material as soon after the interview as possible.

How to Write a Short Story

April 11, 2009 - 8:47 am

Everybody knows writing a story is not easy. Like the drama or the poem, it is imaginative literature that should appeal to the emotions of the readers. Since it communicates the writer’s interpretation of reality, there must be an artistic use of language to signify human experience. But how do we write a great short story? What are the things to keep in mind in order to come up with a short story that works? Here’s a quick guide to get you started:

1. Read

Reading is essential to anyone who wants to write. In order to be able to write a good short story, you must read other short stories first. This will not only give you the motivation and inspiration for your own story, but it will also help you learn how other authors made an impression on the reader and use their style as basis to create your own style and impression.

2. Get inspired

For seasoned professionals, there is no need to obtain inspiration because thoughts naturally flow and they only have to put them into words on paper. But for novice writers, it is important to have one because it will not only help you begin your first paragraph but also keep you going throughout. Your inspiration may take the form of an object. a person, or an event that you just can’t seem to forget.

3. Conceptualize your story

Think of something you want to talk about with your readers. Let’s say you want to relate a story about a couple who fell in love with each other. What about the couple? What is it about them that you are interested to let your readers know? Focus on this idea and think of other concepts that you want to associate with this couple. Suppose the girl’s parents discommended their relationship. What about the parents? What did they do to stop the two from loving each other? This could signal a good beginning for your story. From here, you would have the notion what to write down.

4. Map out the scenes

In order to keep your writing aligned with your pre-conceived story events, it is good to briefly map out scenes of your story on a different piece of paper. Write down the possible characters of your story and list the main events in order. You don’t have to put so much detail on them because this only serves as a rough sketch of how your story will look like.

5. Chooose your point of view

Who tells the story and how it is told is very critical for a short story to be effective. The point of view can change the feel and tone of the story radically. Hence, you must decide carefully before finally resolving with the angle of vision to use for your story. But whatever it is you decide to choose as the point of view, make sure it stays constant throughout your story to maintain consistency.

6. Conceive your characters

For a short story, create a maximum of only three main characters. Too many main characters will make your story confusing since each new character will provide a new dimension for the story. Each character should be more than cardboard caricatures. Make your characters speak naturally in proportion with their traits. Make them believable but mysterious.

7. Furnish a good introduction

When you have everything planned out, start scribbling your first paragraph. Introduce your main characters and set out the scene. The scene must be some place you know much about so that you’d be able to supply the necessary snapshot for a clearly described setting. Make your introduction interesting to hold the reader’s interest and encourage them to read on to the end. It is also important to hold back significant details and the greater part of the action at this point so the mystery is kept.

8. Build up a great plot

From your introduction, draw out events that will eventually create a problem or a conflict for the main character/characters. After that, begin laying out an array of clues to keep the reader interested, intrigued and guessing. Intensify the conflict as the story moves forward. This will not only make your reader enthused to read more but will also keep them riveted to your story.

9. Show don’t tell

The characters should be the ones responsible for expressing the story through their actions and dialogue and not the writer telling the reader what is being expressed. Rather than saying, “Annette was really mad at her bestfriend Christina for stealing her boyfriend”, say “Annette felt an ache in her stomach and a strong pang of betrayal as Christina approaches her and flashes her with a sweet smile. She breathed hard trying to calm herself as she speaks with suppressed anger: “I hope you’re happy now that you’ve proven yourself as a friend.”

10. Use active verbs

Put as much life into your story as you can. In order to do this, employ verbs in the active voice in your story. Instead of saying,”The flower was picked by Johanna”, say “Johanna picked the flower.”

11. Use dialogue every now and then

Dialogue is important in bringing your story to life. Don’t just use it to pad out your characters. Use it to convey your character to identify with the reader. Use it in direct quotes like “Go there!” instead of indirect quotes as “She told him to go there.”

12. Keep references handy

A good reference such as a thesaurus or a dictionary is crucial in creating a good story. You can use them to check your spellings and to find the words which best fit your description. Instead of using one lengthy sentence or paragraph, you can utilize one or just a few words to convey what you want to say. Oftentimes, one strong word has a greater effect than a paragraph full of fancy language.

13. Conclude briefly

Conclusions are tough sledding. For a good ending, it is advisable to experiment and to add a little twist. Make your ending unique but not hanging in a loose end. Make it satisfying without making it too predictable. Keep in mind to keep it short but concise and lingering so that the reader is left with a feeling of resonance. Your conclusion should wrap up everything from start to finish.

14. Edit and revise

After fashioning the last words of your story, it is time to begin the editing cycle. Carefully go through your work and fix all your mistakes regarding sentence construction, word usage, formatting. punctuation marks, diction, spelling, grammar, and descriptive analysis. Scratch out words, phrases and even paragraphs which don’t seem to contribute to the basic elements of the story. After you’re done, let it sit for a while for days and even weeks, then edit it again. Reread your story over and over again at different occasions. This will make you see various things you may want to change to make your story shine at its best.

15. Let others proof read

Have your friends take a look at your work. They may just be able to see mistakes which you have missed. For instance, they may be distracted with some words or lines which you adore dearly. In this case, you have to decide on changing it or cutting it off completely.

Writing a short story may not be easy but it can surely be done. With some knowledge on the basic elements and some passion and patience, it’s effortless to pull together a story with just a few ideas. Just keep in mind that you’re writing not because you have to, but because you want to. Keep the spirit up! Give it a go now!

Top 10 Copywriting Tips

March 22, 2009 - 1:18 pm

1. Be Emotionally Compelling

Your words must have power so people take action and buy. Don’t be dry, stuffy or boring. Rock their world. What you think is a little “over the top” is probably just right. Show them empathy, caring and concern that makes them feel connected and helps them quickly suspend their rational disbelief.

2. Learn to Write Great Headlines

This valuable skill is not to be taken lightly. You need to use numerous headlines in a sales letter. They need to grab your customer’s attention. Look at advertising headline in major magazines. Experts say a good headline can result in 8-10 times more sales than a so-so headline.

3. Use Magic Words not Tragic Words

Use words like “amazing, discover, breakthrough, free, happy, money, you, yes, incredible and others. Magic words positively pre-dispose people to your message. Don’t overuse but don’t underestimate how far a little hype can go. Also, use vocabulary at an eighth grade level or less.

4. Ask Questions

Questions draw readers in and make them get involved. The smart money is on asking only questions you know will get a “yes” answer. Get potential customers in the habit of saying “yes” so when you ask them to buy they are positively prone to say “yes” again.

5. Write to One Individual Reader

Address your copy to one person. “You” not “the public” or the mythical “they.” You’ll create a more personal relationship. People buy more from people they feel they have a relationship with.

6. Brevity the Soul of Wit?

Your copy must take reader through the natural buying steps of attention, interest, desire and action. So brief may not be best. Answer every question in your marketing message so they can naturally take action

7. Share Your Triumph over Tragedy Story

People are drawn in by stories of others who have triumphed over adversity. We tend to root for the underdog. Most entrepreneurs have a story of how their product or service helped them. Don’t hide that story from view. Take it out, dust it off and watch the magic that happens.

8. Build Urgency and Scarcity

We’re bombarded with thousands of marketing messages daily. Build a marketing message that includes a sense of urgency and scarcity so people have a reason to say “yes” now. Say “limited quantities” and offer an early bird special for early sign up. Give customers a reason to say “yes” now.

9. Use Strong Testimonials

You can say great things about you, but a satisfied customer can really brag. To get testimonials just ask. Testimonial should be 4-6 sentences in length and tell a quick story. Each testimonial should answer a different objection.

10. Offer a Powerful Guarantee that Reverses Risk

Many new entrepreneurs worry if they offer a guarantee people will rip them off. In fact you’ll gain far more business with a strong guarantee than you’ll lose from returns. Make your guarantee simple. Amazingly, the longer the guarantee time, the less likely a person will ask for money back.