Archive for February, 2009

New Technical Writer: Don’t Confuse Your Reader With Your Words

February 13, 2009 - 6:53 pm

OVERVIEW

Stop confusing your Reader with the words you use. Your Reader is trying his/her best to understand how your product works without having to figure out your writing. Here are some writing guidelines to help you stop baffling your Reader.

SAME CONCEPT: SAME WORDS

User Documents are not meant to be entertaining. Do not try to be creative, especially by using synonyms for specific concepts in your product. When you talk about a topic use the exact same wording to describe (or name) the topic everywhere in your User Document.

For example, the “Same Concept: Same Words” guideline, says that if there is a control on your product called the “Activation Button,” then everywhere you talk about that button use the term “Activation Button.”

Don’t be “creative” and use words like “Activation Control” or “Start Control” to refer to the “Activation Button.” Using the different wordings forces your Reader to have to stop and think “Is this the same thing as ‘Activation Button’?”

DIFFERENT CONCEPTS: DIFFERENT WORDS

I bought something on the Internet that had a rebate available for it. When I ordered the product, I was given a “Tracking Number” to monitor the progress of my order. This is common for orders from large companies.

When I applied for the rebate, the rebate company used the same word, “Tracking Number,” but this time it meant “their rebate tracking number.” When their website asked for “tracking number” I entered the only one that I knew, the product ordering tracking number. I was wrong; the rebate number was a totally different thing.

The Rebate number is different from the order tracking number and should have a very different name from the order tracking number.

One might argue that “the rebate company is a separate company, and must handle rebates for all sorts of sellers.” Sure, but they can use a very specific name for their rebate tracking number. They can call it the “Rebate Identification Number.” That name would not be used by any selling company to track an order. The problem is solved. No User would confuse “Tracking Number” with “Rebate Identification Number.”

QUIZ

Given the information in the previous two sections of this Article, wouldn’t it be really silly if the rebate company originally called it the “Rebate Identification Number” and then unannounced switched to calling it the “Rebate ID”? Answer: Yes, it would be very silly. The change forces the Reader to have to ask, “Is this the same thing as the ‘Rebate Identification Number’?”

It’s not that your Reader is too stupid or lazy to figure out what you mean. It’s that your Reader has better things to do than to decipher your writing.

WORDS YOUR READER DOESN’T KNOW

Jargon is the shortcut language of any industry. Make sure that if you use jargon in your User Document, you explain what it means. If the writing project can afford the bit of time, I recommend that you include a glossary in your User Document. Define all the jargon, acronyms, and words that you might use in ways your Reader might not expect. A great example of the latter are “debit” and “credit.” The common understanding of these words is exactly opposite to those in the accounting (banking) profession.

TIP: Be suspicious of any words your spelling checker identifies. Ask yourself two questions when your spelling checker identifies a misspelled word:

* Did I really spell that word incorrectly?

* If it’s spelled correctly, am I certain that my Reader knows what the word (or acronym) means? If it’s not in the spelling checker’s dictionary it might not be in your Reader’s vocabulary.

DON’T BE AMBIGUOUS

I have a notebook computer running MS Windows XP. If I am using the Media Player and I press the keys to hibernate the computer (put it into an energy-saving sleep state), something warns me that hibernating will lose my place in the video. It then asks: “Do you want to continue? Yes/No.” Continue what?: Continue hibernating, or Continue watching the video? It would only take one or two more words to remove the ambiguity.

THE BOTTOM LINE

When you revise your writing, make sure that your Reader does not have to guess what a word might mean. If you mean the same thing as another concept, use the exact same name. If you mean something different, then use as different (unique) a name as you can. Define jargon, acronyms, and any unusually used words. Eliminate ambiguity.

Your reader is uncomfortable enough having to read your User Document, instead of using your product. Don’t make things worse by using wording that makes your Reader have to work out its meaning.

How to Write a Bibliograpy

February 13, 2009 - 10:46 am

What does Bibliography mean? Webster’s Dictionary describes it as the history, identification, or description of writings or publications. It can be anything E-book, journals, Comics etc.

Making a Bibliography might look very simple but it requires a great attention to minute details. It will become a bad publicity to your book in case it is not made first time right.

When making a Bibliography make sure we read the documents for which the bibliography is needed. And a thorough reading will help all the better.

Steps that can be used:

. Make a List, First, of all the sources that the author has used.

. Collect all the titles, references etc that has been used in the book.

. When more than one reference is used, make sure to arrange it in alphabetical or any other preferred order based on the content of the body.

. Make sure the information that comes from the bibliography comes from the Title page of each book, and not from anywhere else.

. Cover all the dates of publication, for each reference.

. If any special references to web pages etc, find out the credibility of the data contained in the same. For example like who is the author, his other works etc.

. Include the most relevant information always. Extra information might tend to mislead the readers.

When everything is listed, arrange it all in a required fashion; give formatting for the Bibliography as required. Here your work is complete now, give a review and you are ready to go.

5 Writing Myths Busted

February 11, 2009 - 9:24 pm

One common element whenever human beings gather is the need to talk and share experiences. Often that need turns into something a little more fun, a little more dangerous — gossip. Gossip is often fun but it can also be dangerous because it spreads quickly (because it is fun) and often distorts or even completely avoids the truth. Gossip creates myths in many fields and professions, and the field of writing is especially prone.

The top five myths about writing are:

Myth 1: Writing is easy for some people. Let me tell you that is just about the biggest myth going. I have been a professional writer for going on three decades now. I also know many other professional writers of various ages, experience, and income. I don’t know a writer that will tell you that writing is easy. Writing is brutal, hard work and there are times when I think it would be easier to simply open a vein as Red Smith said. However experience and practice can make many writing tasks easier. There are some writing tasks that I can almost accomplish on autopilot because I have written that specific format and/or topic a lot.

Myth 2: Writing requires talent. I won’t lie. Talent can certainly help and talent is what separates the great writers from the good writers. But the truth is that talent is not enough to make a writer great or even good and talent is not a necessary requirement to be a good writer. Writing is a skill that can be learned, developed and honed. If you practice your craft, if you read the writing of others to learn more about your craft, and if you seek and accept guidance and suggestions about your writing then you will improve and grow as a writer. Dedication harnessed with talent can create amazing results but if I had to pick just one then I would go with dedication. You can always increase your skill level through dedication.

Myth 3: Writing isn’t an useful skill. I have made my living as a writer for my entire professional life but even if you don’t intend to make your living with words you will need this crucial skill. There simply isn’t a profession that does not involve writing. Perhaps the form will vary, but written communication is the cornerstone in every professional field. Your writing ability will often impact landing a job as well as advancing in your career. Today written communication is even more crucial in professional and personal relationships.

Myth 4: You can’t make a living as a writer. I can remember when I told my father that I wanted to be an English major in college. He was very worried that I wouldn’t be able to support myself. The truth is that I have never had trouble finding a job and today I own my own business because of this flexible and important skill. Not only can you make a living as a writer but writing is an essential tool for many other careers and professions.

Myth 5: Writers block is alive and torturing writers as you read this. I’m not dismissing the difficulties inherent in dealing with writers block but whenever I talk with writers purportedly suffering from it they fall within two general groups. The first group actually creates their own block by insisting on the perfect place, mood, or alignment of planets in order to write. This is beyond ridiculous. One of the many benefits I gained from years of newsroom experience is the ability to write in almost any condition or mood. Deadlines will teach anyone how to give writers block short shrift. The second group I have more sympathy for as their problem really is internal in nature. Usually the problem is that the particular story (whether fiction or nonfiction) they want to tell is not yet finished cooking in their brain. In this case, while the writing may be stalled I don’t agree that it is blocked. The writer must listen to that inner voice and respond appropriately. Sometimes the idea needs more time to percolate and sometimes more research and/or planning is necessary. Once the proper adjustments are made the writing will begin to flow again.

Don’t let your writing fall victim to these five myths about writing.

Book Review: If I Did It - Confessions Of The Killer By The Goldman Family

February 11, 2009 - 9:16 am

Yes folks, it’s the long awaited OJ Simpson confession book! Except that in OJ’s mind it was anything but, he claims it is a fictional account of how we would have done it, if he had done it! I have lots of problems with this book, not least of which is what was going through his sick and twisted mind to want to write the book in the first place. If you are innocent this book makes no sense. And if you are guilty, it makes even less sense, unless you are trying to confess and clear the air. But he plainly says, time and time again that it is fiction.

The good news is that through the intervention of Fred and Kim Goldman OJ Simpson will not see one dime of profits from its sale. The not so good news is that OJ did manage to get the almost $700,000 in advances before the project became public.

Really it is the story behind the book that makes better reading than the book itself. When the Goldman family heard that OJ Simpson was having a book written they moved into high gear to prevent its publication and his ability to profit from the misery. In the 13 years following the guilty verdict Simpson has paid exactly nothing of the money awarded to the Goldman’s. He relocated to Florida to avoid the pesky Californian judgment, and spends a happy life playing golf and who knows what else. The award was somewhere in the 18 million dollar range, with interest that now amount has more than doubled, one report puts it at 39 million dollars.

With ammunition like that the courts sided with the Goldman’s and gave them the rights to the book. Unfortunately there were strings attached, a bankruptcy was involved. And after much soul searching they realized that although they had won, the win came at the great price of now having to publish the book.

The end result, is a book that I am sure OJ hates! Yes his material is included in its unchanged entirety, however it it preceded by some commentary by Fred Goldman, and the actual Ghostwriter Pablo Fenjves. The book is ended by a chapter written by Dominick Dunne.

Let’s take these sections one by one. Fred Goldman explains at length the problems and frustrations his family felt when it became public knowledge that OJ Simpson was planning a tell all book. One article I read claimed that this section was ‘under edited,’ that might be true, but it is also written from the heart. And I will take that every time over the sterile grammatical style favored by many large publishing houses. It worked for me and set the scene well.

The most damning testimony to the guilt and obvious truth to the ‘hypothetical version of events’ comes from Ghostwriter Pablo Fenjves. In a matter of just 20 pages Pablo tells a very interesting side of OJ Simpson. Although I had no doubt of his guilt from the time of the actual 1993 events, Pablo makes a case that is so strong event Judge Ito and that half wit jury would have found OJ guilty.

Next up, is the OJ Simpson text. Pretty much it is a self serving and nauseating piece of garbage. He explains at great length what a nice guy he is, and what a bad person Nicole Brown was. The one chapter of interest is the one detailing the events of the fateful night. With the exception of the ’second man,’ it likely is one of the few factual parts of the entire manuscript.

The final chapter is written by Dominick Dunne. Dominick covered the original trial for Vanity Fair, and became a close friend of the Goldman’s as a result. His is an interesting story, he too lost a child at the hands of a murderer, his daughter was killed, and the killer walked free after only 2

Application Letter Sample Warning

February 9, 2009 - 3:47 pm

So, you finally finished your resume and now it’s time to write your application letter. You know in order to get noticed you need your application letter to really stand out to the employer. You want that interview, but you don’t know the first thing about writing an application letter. You understand all the key points, but you’re no good at organizing your thoughts on paper. So you turn to your computer, log on to the internet and Google “free application letters”. Hundreds of websites pop up offering tons of free application letter samples. You can’t believe your luck. You click through a few sites and find a letter you like. Your are positive that this one that will knock the socks off the hiring manager. You feel confident, as you copy and paste it onto a word document, that this letter will pretty much guarantee you an interview. Let’s face it you found it online and it claims to be written by a professional, therefore you can’t go wrong. You change a few words around, sign your name and off it goes. Now all you have to do is wait for that phone to start ringing.

Let me tell you, you are going to be waiting a long, long time for that call. Take heed of this application letter sample warning. While these sample letters can help guide you in how to write an application letter, they should never be used as a substitution for your real work. Most employers review a countless amount of application letters and resumes daily. Do you really think that the free online application letter sample you “borrowed” is going to grab their attention? Chances are no. Is your application letter sample going to be original? Probably not. Is the application letter going to be written to show how you meet the employer’s needs? Again, probably not.

Do you think you are the first person to go looking on the internet for free cover letter samples? In this day and age of the internet where you can find anything you need, chances are you are not the first person to use a free application letter sample. In fact it probably happens more often than you imagine. These employers received countless amounts of resumes and cover letters. They are so seasoned at reading application letters they will be able to tell yours is not your own after the first paragraph. This is why your application would really need to stand out to the employer. It’s doubtful that the application letter you found online is going to do that for you.

A good application letter consists of a few key elements. Essentially it’s what you can do for the employer. The letter should show why the employer would be making a mistake not calling you for at least a interview. Your application letter needs to highlight some key points in your resume, specifically those points that qualify you for the job you are applying for. How is a letter that you found online going to do that? In order for your letter to get notice it needs to be original, and show your passion for your work. Can an application letter you get online be original? That is highly doubtful. Your letter also needs to ask for the opportunity to be interviewed and needs to give the employer options to make that happen. Again, would your sample application letter provide that? If I was a gambler, I would bet the house that the answer would be no.

Instead of using the internet to find a free application sample letter to pass off as your own, use the internet to research how to write a effective application letter. Anything that has the word sample in it, is meant to be just that. A sample. Something to sort of push you in the right direction. The most important things to remember is that applications letters should be original and they should represent you. The only person, who can represent you, is you. Why would you want to take an application letter written by someone who does not even know you? Only you know why you would be perfect for that one job. Why trust a generic letter to get that point across to the employer?

Why The Information Age Is Dead!

February 8, 2009 - 9:39 pm

The Information Age is dead. We stand at the cusp of a new era. We used to live in the Information Age, but you know how it goes when everyone jumps on the bandwagon. Too much of a good thing became a bad thing. I know you feel it. We both know that everyone is glutted with more information than we know what to do with. You surf the web and there is page after page of information, right? But how do you sort and sift through it all and solve your problems? How do you get what you need&ndashquickly?

We used to want information, but now we want something better. That is why we are at the dawn of a new age. The Recommendation Age. People don’t want information. They want solutions to their problems, and that means they need information filtered through the expertise of someone who has gone before them. And that’s going to be YOU! You will write your book and become a noted expert in your field.

In his book, The Long Tail, Chris Anderson wrote about the dawning of this new age. He said that what people want is not more information, but a trusted guide who can give context to the content.

Your Life Experiences and Passion position you with the natural readiness to make recommendations to others. It’s human nature. You do it all the time in small ways. Think about it. Haven’t you ever told a friend&ndashor even a stranger&ndashto steer clear of a product that doesn’t live up to expectations? Haven’t you ever suggested a tasty dish at a restaurant, or told a friend why she would absolutely love a movie you just saw?

I know you have. We all do this. That’s the power of Recommendation Marketing. It’s time to cash in on a natural human tendency. Since four out of five people want to write a book, chances are excellent that you have always dreamed of telling your own story and leaving your own legacy.

It’s time for YOU to write your book and become an expert millionaire.

Where do people go when they have a problem? The Internet. This is where you should start. Get your book online.

We are drowning in information. The Internet’s greatest advantage is that it level the playing field. Now everybody with a computer and an internet connection has access to the same information. But the greatest asset has also become the greatest annoyance. Today we are drowning in information. We are over-communicated to.

What will you recommend? How will YOU solve other people’s problems. The type of writing that sells the best on the internet is non-fiction. People want help solving their problems.

What problems will YOU solve for people? Look to your own life. What do you do naturally that other people struggle with? What challenges have you overcome?

The information age is dead. We’re drowning in information. What people want now is for an expert to recommend a solution. The Recommendation Age is here. Take your place as an expert and cash in on the Recommendation Age by writing YOUR book&ndashstarting now!

Writing Exercise 4: A Space Alien Might Make A Good Priest

February 8, 2009 - 5:26 pm

As we develop our characters, we often fall into the habit of placing them in a single type of role and plot. For example, for years one of my characters was stuck on a California horse ranch. Having him on the ranch felt comfortable, familiar.

He became boring.

Now my character is a modern day pirate turned Catholic priest with an attitude you would not expect from a priest. He is unpredictable, sometimes shocking, and enjoys every second of it. I have discovered things about his personality I never suspected.

Write a scene involving your character in a completely new situation.

Has your gentle mother character been in the kitchen for too long? Let her have a wild night out on the town with the girls! Dancing on tabletops and stuffing money into a male stripper’s thong would be good for her.

If she is uncomfortable in a nightclub, have something happen that shakes her out of her uneasiness. Maybe she starts a brawl with a gang member? Hey, it could happen.

Have your mysterious dark hero, whether human or alien, attend a PTA meeting in place of his busy sister. Will he volunteer to bring the cupcakes for the next school function or will he upset the meeting in some manner?

Have the new situation force your character to do and say things he or she normally would not, even if stuck with a burning fork. You want your character to express his or her deepest self.

Doing so forces your character to overcome fears and inhibitions. Maybe he or she will develop new fears as a result?

This will open wide your choice of future plot lines.

Placing your characters into unexpected situations is a great way to add dimensional layers to your characters, as well as develop fresh plot ideas.

The Book Writer’s Guide To Self-Publishing

February 7, 2009 - 7:15 pm

Self-publishing has become common practice for many writers who want accolades of having a book published, no matter who publishes it. Writers choose self-publishing for various reasons. Many writers desire the freedom and business aspects of publishing work independently. A self-published writer is one who is in control of every aspect of their published work. The publishing industry defines self-publishing as authors publishing their own books or other media, instead of with a third-party publisher. Today’s technology has increased the pool of self-publishers, but it still represents only a small percentage of the publishing industry in terms of sales. The proliferation of media channels, such as blogging, video, and audio content, has contributed to the increase in self-publishers.

THE BUSINESS OF SELF-PUBLISHING

The business of self-publishing books and other media is different from any other business. The absence of a traditional publisher makes self-publishing unique. The author of the content takes on the role of the traditional publisher. The author controls the editorial content, arranges for printing, markets the material, and distributes the material to consumers and retailers. Self-publishers publish their books in printed form, or choose print-on-demand with no inventory. Many self-published authors decide to subsidize their work rather than making money from it. Digital printing technology has evolved self-publishing into digital photo book printing. Self-publishers are able to get individually printed photo books from firms like Apple’s iPhoto, FotoInsight, Snapfish, and Printing-1.

THE MOTIVES OF SELF-PUBLISHING

Many writers have varied motives to self-publish. One common reason is the writer’s work is not of interest to the commercial publisher, and otherwise not marketable. Another common reason is the writer prefers to retain complete editorial control over content. Many writers are unwilling to compromise editing of their work, and some writers prefer to have their work presented “as is.” Literary agents and book agents may deny publishing a book because the author is unknown and does not have a substantial resume. Self-publishing may also be an alternative for writers who have written material on a popular topic but the topic is only interesting in a small geographic area. Literary agents and book agents may also deny publication because the book addresses an obscure topic in which few people are interested. Writers of controversial works may also choose to self-publish, as many traditional publishers refuse to work with controversial writings. Some authors choose self-publishing because they want a larger royalty from retail sales.

IS SELF-PUBLISHING A SHORTCUT TO SUCCESS?

Self-publishing is not a shortcut to having a printed book. Depending on what your goals are, it may or may not be a direction you would like to take. In the hard copy world, self-publishing is costly. Getting a book into print costs more money than many writers want to spend. This is why the Internet is a blessing — it’s free. You can either start up a free website of your own and post your novel, or pay a small monthly sum and sell your writing online. If you can write well enough to catch someone’s attention, your readers may be willing to pay for a download of your book. By self-publishing online, you avoid the normal book publishing costs and still get exposure. Who knows, you may be lucky and grab the attention of a publishing guru who thinks you could make a lot of money from your self-published book.

Whatever your reason is for self-publishing, you should know that self-publishing requires extensive work. Self-publishing involves a long list of tasks, which include prepublication and publication. Prepublication includes editing or obtaining editing for the manuscript, proofreading, establishing yourself as a legal retail business, and obtaining an ISBN “Cataloging in Publication” number.

The publication process involves formatting the manuscript, providing front matter and back matter, and providing cover art for the front and back covers and the spine of the book. Self-publishers must also obtain printing quotes, determine how to deliver the manuscript to the printer, and pay for printing and delivery of finished books.

Publishing a book online is easier than publishing in the world of hard copy. The result is not as glorified, but it is a step towards success in the published realm. The more experience you can get writing, the better writer you will be.

Getting A Publisher & Getting What You Want

February 7, 2009 - 12:51 pm

In the basic scenario of book publishing, a writer finishes a book and then finds an agent who helps sell the book to a publisher. When someone asks, “How do I find a publisher?” they’re often looking for the details of this scenario. But let’s backtrack a little. The answer to this question has to do with what you as a writer want out of the publishing process as well as what the publisher wants. It’s best to be as clear as possible on both counts. Here are a few things to consider.

What You Want

What exactly do you want for your book? It’s possible that your answer can save you a lot of time and heartache. Here’s an example. A writer recently emailed me about wanting to find a publisher for his book on dealing with sickle cell anemia. He said he felt it was a really important book and that people would be interested in the information. That’s great, but if his main goal is getting his book into the hands of those coping with the disease, he doesn’t have to go with a big traditional publishing house in order to do that. He can self publish and take the book directly to doctor’s offices, support groups and sickle cell organizations.

Do you want a book that tells a family story that will be a legacy for your children? Do you want a book that will establish your expertise and help you get started on the speaking circuit? You can accomplish these things by self publishing. A prominent ghostwriter recently published a book about his trade and landed a television interview where he discussed how politicians get their books written. The author was introduced as a “ghostwriting guru” and his book was prominently displayed at the end of the story. There was nothing that would have told you the book was self published. It didn’t make a difference that it was. He still got the notice, was still seen as an expert.

Do you want to go for the whole enchilada–traditional publishing house, book tour, the status of having the validation of a publisher? That’s fine too. Which brings us to…

What Publishers Want

Publishers are reviewing tons of manuscripts daily. How do you get your submission package to stand out from the others? By giving what they’re looking for.

They want good writing. That’s a given, but how do you deliver? First of all, be in a mode of constantly learning about your craft. Take classes, workshops, join a writer’s group. Next, hire someone to help you. There are many editors who assist writers in getting a manuscript ready for submission. Some agencies even provide editing as part of their services.

The next part is harder. It has to do with that magical term “platform”. Everyone these days talks about how publishers buy on the basis of your platform. In fact your submission package, fiction or non-fiction, will be all about showcasing your platform. Here’s what they’re looking for and how to demonstrate it.

Who you know and who knows you: Have testimonials and blurbs from known and noted people featured in your package. If you have a few big names behind you, that’s more power for your marketing machine.

Do you have a following? If you put out a newsletter or other regular media you’ll want to show how many subscribers you have. If you have a killer website, tell the number of hits you draw each month. If you sell a product, give sales figures to show you know how to produce what your customers want.

Are you in front of people all the time? Tell what media you already have under your belt. When and where were your last speaking engagements? Describe any radio, television, newspaper or magazine interviews you’ve done recently.

If you’re lacking in any of these areas, it’s never too late to change your situation. Polishing your prose and your persona are the best steps you can take to attract a publisher. They’ll also help ensure your success if you decide to go it on your own. Remember, any improvement on your writing or marketing fronts will never go to waste!

How Do You Write A Book Report?

February 5, 2009 - 8:15 am

Some time or the other during our schooling most of us have been assigned the task of writing book reports. We have to live with book report assignments throughout our academic life, grade school, high school and college.

Book reports in grade school are easy as the writing is simple and most of the times the teacher takes an indulgent view due to the student’s age.

High school book reports are a different ball game altogether. Are they not? The teacher expects us to know what we are doing and the assignments too are more unmanageable. This is the time when we are expected to know how to write a book report properly without those irritating grammatical errors and fledgling mistakes.

Nobody likes remarks like “see me after class” from teachers but still every one of us has had to face them one way or the other during high school.

College, again, throws new challenges when we find that the concept of book reports is not crushed but haunts us under a different name altogether. Suddenly book reports are termed as essays and instead of broad stories the assignments become more focused on an idea that is a recurrent element in the book and specific themes. Instead of indulging in wishful thinking and hoping we were still in high school where things were easier, it is the time when we are required to unearth our talent if we have any.

If we really get down to doing it seriously, learning how to write book reports is pretty elementary. It is simply a matter of organizing and doing it chronologically instead of indulging in it in a haphazard manner. The best way of writing book reports is to work on it step by step. Without trying to make notes in-between, first read the entire book. Writing notes in between may result in loosing focus of the underlying idea the author wants to convey.

The second step is to decide on the focus of your report as per the guidelines of the assignment: depending upon whether the assignment is for a general summary or a focus on a particular aspect of the book, prepare a general outline and structure of the report.

Once the outline and the structure is ready all that is needed is to keep in mind the book’s major themes and start pouring your heart out on what you feel the book and the theme is all about. After all, a book report is all about enlarging the small issue.

However, if you are practically a novice in writing book reports and/or want to improve your technique, there are a good number of websites that can assist you in your endeavor.