Thursday, August 14, 2008

This Clever Catalog Copy Rolls...

I love Crate&Barrel catalogs. I think they are among the best written consumer product catalogs, anywhere.

Here is an example:

"Kik-Step Stools - Kick it and it rolls. Step on it and it locks. Clever spring-mounted retractable casters take this handy steel stool wherever you need it..."

ACTION verbs in the IMPERATIVE mode -- kick it, step on it... it tells you exactly what you should be doing. Nothing is left to chance here.

It addresses YOU - "wherever you need it..."

You hear the music? "Kick it and it rolls. Step on it and it locks."

Just when you're wondering if this thing that OBEYS your commands is actually ALIVE, the writer anticipates your subliminal question -- "CLEVER spring-mounted retractable casters..."

Ladies and gentlemen: this thing is not a dumb stool. It's a CLEVER stool. It will obey you and make you HAPPY. It's an obedient puppy in the shape of a stool.

See how deep good copy penetrates? If the writer who wrote this copy is giving a workshop, take it.

Wednesday, August 13, 2008

Three Frame Maker Tips

Renaming the FrameMaker Books

Think twice before changing the name of a FrameMaker book file especially if the book includes TOC, index, List of Figures (LOF) and List of Tables (LOT) files.

Because when you try to compile a new PDF book file, FrameMaker will try to locate the newly-named versions of the TOC, IX, LOT, and LOF files.

When it can’t find them, it will refuse to create a PDF book. You will have to re-create those TOC, IX, LOT and LOF files to compile the PDF file of the newly-named book.

Images disappear in PDF?

You save your FM document as PDF but the images in anchored frames disappear. All you get is blank frames.

Solution?

Select File > Preferences > General and check the Save FrameImage with Imported Graphics check-box.

Re-generate the PDF and all your images should be there.

Installing new or missing fonts for FM

1) Save (or extract) the fonts to a folder on your system.

2) Go to your Windows Control Panel > Fonts screen.

3) From the menu, select File > Install New Font… to display the Add Fonts dialog box.

4) Find the folder in which you have saved the desired font. Select it and make sure it appears in the List of Fonts list box. Make sure the Copy fonts to Fonts folder check-box is checked.

5) Click OK.

6) When you open your FM document, you should see the new font listed when you select Format > Font from the main menu.

(The new font should be accessible from other Windows applications like Photoshop as well.)

Monday, August 11, 2008

Olympics Observations...

1) Matt Furey is such an excellent writer and opportunity marketer. Whenever there's a momentous event, you can count on it, Matt will fire off a personal and well-written letter on the occasion and will not of course forget to plug in his products as well.

This afternoon I found in my mail box his take on Michael Phelp's second gold medal and the phenomenal 4x100 race with the French. Online marketers: take notice and emulate.

2) A failure in information design: isn't it annoying that NBC will not broadcast maximum scores in any given competition?

For example, NBC anchors will repeatedly tell us that an American athlete just scored 15.87 and that it's an "excellent score." But HOW excellent is that? I have no idea since I do not know what the PERFECT score is.

If perfect score is 16, then I can make that judgment for myself too and agree that it's an "excellent" score indeed. But what if the perfect score is 20, 50, or 100?

It's baffling that NBC continues not to provide the audience what the perfect score is in a competition. If I were them, I'd not only broadcast the perfect score but also include a tiny pie-chart right next to the individual score, visually displaying how close the individual competitor got to achieving that perfect score. That's a piece of must-have information graphics that is sorely missing from NBC broadcasts.

3) Image sacrificed to cuteness. Have you seen the GE commercial that shows an ancient Greek disc thrower bringing down the Parthenon when the wind changes its course? I thought that was a DISASTER of a commercial for GE's Wind Power projects because, although humorous, it plants in the mind of the audience the IMAGE that wind can be a DANGEROUS element leading to DESTRUCTION of PRICELESS TREASURES.

Wow! Whoever thought of that commercial really did an excellent job of planting the seeds of doubt in the minds of those who perhaps already had a question or two about wind power to start with. That was a textbook case of sacrificing function for form.

4) An odd comment in the year 2008. I was taken aback by a casual comment made by one of the NBC commentators, following the fall of an American gymnast during her performance (I am paraphrasing): "...that was like tearing her wedding dress in the aisle..."

I found it very peculiar that the male commentator chose such an image to describe the female gymnast's plight.

Would he describe the foul up as "...like tearing his tuxedo's pants in the aisle..." if the athlete in question were male?

Thursday, August 7, 2008

Great Headlines

"Boat Industry Takes on Water"

~ Business Gazette, August 1, 2008

"In Women's Soccer, U.S. Finds It Can't Kick the World Around Anymore"

~ Wall Street Journal, August 7, 2008

Thursday, July 24, 2008

Google Announces KNOL

There is something new from the ever-inventive Google Team: a KNOL!

Blogs are great for quickly and easily getting your latest writing out to your readers, while knols are better for when you want to write an authoritative article on a single topic. The tone is more formal, and, while it's easy to update the content and keep it fresh, knols aren't designed for continuously posting new content or threading. Know how to fix a leaky toilet, but don't want to write a blog about fixing up your house? In that case, Knol is for you.

Except for the different format, you'll get all the things you've come to expect from Blogger in Knol. Like Blogger, Knol has simple web authoring tools that make it easy to collaborate, co-author, and publish.

It has community features as well: Your readers will be able to add comments and rate your article, and, if you want, they'll be able to suggest edits that you can then either accept or reject. And, just like in Blogger, you can also choose to include ads from AdSense in your knols to perhaps make a little money.

One other important difference between Knol and Blogger is that Knol encourages you to reveal your true identity. Knols are meant to be authoritative articles, and, therefore, they have a strong focus on authors and their credentials. We feel that this focus will help ensure that authors get credit for their work, make the content more credible.

All in all, I agree with Google that Knol will be a great new way for you to share what you know, inform people about an issue that is important to you, raise your profile as an expert in your field, and maybe even make some money from ads.

You might consider it both as a stand-alone platform and as a supplement to your existing blog or web site. So many options, so little time :-))

P.S. BLOGGERS BEWARE -- A Knol is not a shallow marketing tool since the depth and quality of the AUTHORITATIVE articles published as a Knol is truly amazing. I posted up an experiemental knol myself but frankly did not like the quality since it was my very first "knol."

It'd be interesting to see how this new Google "article platform" will fare against such established article depositories as Ezine Articles of Chris Knight.

Saturday, July 19, 2008

A Great Opening Paragraph

"WHEN T. S. Eliot said that it is the journey, not the arrival, that matters, he surely was not thinking of a journey to Paris on a commercial airline, at a cost of $1,400, following a two-hour wait on the tarmac, in which cocktails on overseas flights are no longer free."

http://www.nytimes.com/2008/07/20/fashion/20bummer.html

It turns a well-known line by a famous poet on its head while immediately focusing our attention on a current and urgent topic -- the high cost of travel. It's tastefully disrespectful of authority, witty and pertinent. Wastes no time to get to the heart of the issue.

Wednesday, July 16, 2008

Magic of Giving It Away

"Last fall, one of the largest subscription websites decided to make all of its content free and abandon the subscription model. That website was NYTimes.com. After opening up their website, they saw a traffic jump almost immediately of over 2.2 million unique visitors to the site.

Following this news, Rupert Murdoch seriously considered leaving his more than one million subscribers behind and opening up WSJ.com for free as well. He didn’t, however he did open up much more of his content and has since seen a 256% increase in unique visitors this year."

~ Mequoda Daily


Monday, July 14, 2008

Black Hat Blogging

Don't you hate it when "black hat" artists grab your articles and reprint them by flattening all your live links and then, to add insult to injury, INSERT their own RANDOM affiliate word-links to the text?

I have no idea why they do it because the result is a terrible stupid piece of text with an impossible URL.

Here is an example how one of my articles was butchered in this fashion:

http://deaqzhjrymekk.blogspot.com/2008/07/3rd-big-myth-of-search-engine.html

The URL is impossible because it is randomly generated by a black hat BLOG GENERATOR software. Not only the URL but the "name" of the blogger is also randomly generated.

And the sad thing is there is practically no defense against this kind of pirating. If I flag this blog and pursue the matter it will be deleted but 10 or 30 more will crop up before they even do so. It's a no-win fight up the cyber creek.

So what do I do? I insert my own "thank you" comments with my live link thinking "if a spider follows the links on this page it just might follow mine too and get me some Google-love"... yet I also know that it is a highly unlikely outcome.

So why do these pirates keep generating these random blogs by reprinting people's articles (most of the time published on sites like Ezine Articles) ? Because they are greedy and inexperienced and they really think they can make some money out of these totally bogus blogs. All they do is pollute the Internet.

USEFUL TIP: To catch such pirated and butchered "editions" of your articles just create a Google Alert account with your name as the keyword. Every time one of your articles is published on the Internet you'll receive a Google -email. Very easy to keep track of. The results may just amaze you.

Tuesday, June 17, 2008

Monday, June 16, 2008

How Not to Design a Squeeze Page

I did not make this one up folks. This one is for real and is an excellent example of how NOT to design a squeeze page, especially one set up to sell a very expensive web-based service.

The rule is -- the more information you ask from your prospective customers upfront, the lower will be your conversion rate.

How many people do you think have signed up for this "Free software demo" by providing all the following MANDATORY information (all the fields with asterisks)?



What were they thinking?

You have to be really desperate for this software in order to provide all that MANDATORY information before allowed to watch the demo.

The kicker is, they won't tell you WHAT exactly their "service" is all about either. No. You have to give them all that information about yourself (including your FAX NUMBER) and THEN, and only then, they will allow you to have a peek at what they've got.

Good luck!

Rule of thumb: if you'd like to have a good conversion rate, ask no more than NAME and EMAIL address. That's it. Some people are so hungry for your e-mail that they even skip the name.

P.S. The cost of this service that you cannot even sample before giving up all that information is $5,000 upfront for "set up"; and then $300 recurring fee every month. So I guess they are interested only in people with really a lot of cash and a lot information to give up. I hope that strategy is working for them.

Sunday, June 15, 2008

Critically Scarce"?

Can something be "scarce" but NOT "critically scarce"?

From New York Times (June 7, 2008):

"... housing was critically scarce along the Gulf Coast after Hurricane Katrina."

?

This is like saying "the house was painted green in color." Green is the color, and what's scarce is by definition "critically" so.

It's enough and more proper to say something is painted green, period; or that the housing is scarce. Full stop.

Saturday, June 14, 2008

Non-Parallel Construction

Even important publications like NYT or WSJ are not immune to generating weak prose, constructed with non-parallel clauses.

Here is one from New York Times (June 7, 2008):

"The hunger strike is meant to pressure federal officials, and comes as Congress is debating an expansion of the guest worker program..."

There's nothing "wrong" with this sentence except a passive-voice clause is followed by an active-voice one.

This is how I'd edit it:

"The hunger strike aims to put pressure on the federal officials, and comes as Congress is debating an expansion of the guest worker program..."

Friday, June 13, 2008

Scheduling Posts

Now you can schedule your posts in advance if you are using Blogger.

WordPress had that functionality for quite a while.

I congratulate Blogger for the innovation for a good reason -- whenever I had WordPRess blogs they've been assaulted without mercy by comment spammers.

With Blogger, knock on wood, that has never been an issue and I'm using Blogger since year 2000. I hope one day WordPress developers will also learn how to protect their bloggers against such nuisance.

Something new -- if you're looking for an HTML editor which has a built-in advance scheduling function, try Xsite Pro 2.0. It is the only HTML editor I know (not Dreamweaver, not GoLive) which allows you to schedule your web pages in advance and publishes them according to your schedule. Indexing robots love that time-release stuff.

Thursday, June 12, 2008

Technical Editing

EXAMPLE: Once the startup condition is attained, the user can launch the module.

BETTER: After starting the system, the user can launch the module.

Wednesday, June 11, 2008

"Energizing"

Some of the worst excesses of copy writing give the trade a bad name.

Take the following lonely adjective I noticed printed on the label of a bottle of shampoo:

"Energizing..."

Now what the heck does that mean, really?

Energizing WHAT? Does it mean I'll have more energy when I use that shampoo? Of course not.

How much more energy we're talking about? Are we talking in terms of Calories?

Etc. Etc.

Total nonsense and yet someone was paid to write that, and another to place it on the label.

When I see empty rhetoric like that masquerading for good writing, I feel like breaking my keyboard and selling used cars for a living.

Tuesday, June 10, 2008

MEGA MILLIONS - "Learn from History" ???


(Click the image to enlarge it.)

That's the first sentence that greets you when you visit the "Recent Drawings" page of MEGA MILLIONS LOTTERY.

LEARN FROM HISTORY? If we could do that, that would mean the lottery drawings are NOT random!

The whole point to a lottery is that all drawings are (supposed to be) RANDOM and INDEPENDENT from each other.

For anything to have a HISTORY it has to have events that are NON-RANDOM and NON-INDEPENDENT.

I'm really surprised that the Mega Million lottery officials are suggesting that we can "learn" anything from studying the "history" of these drawings.

What do they exactly mean by that, I'm really at a lost.

For a perfectly random and FAIR drawing, we should NOT be able to learn anything by studying the "history" of past drawings.

Do the lottery officials know something that we don't?

Or is it a case of a careless copy writer who has not taken probability at college and who does not know what an "independent event" means?

They need to hire a good technical writer, right away.

Tuesday, June 3, 2008

STC Annual Conference, Philadelphia, PA

I've been at the STC (Society for Technical Communication) Technical Communication Summit and Annual Conference in Philly, PA since Sunday. A very exciting event for all technical communicators, with 1,250 in attendance from all across the USA, Europe, Japan, India, Korea, Israel, and a few other countries.

STC has organized 3 solid days of presentations on half a dozen subject tracks. There were so many workshops and seminars that I wanted to sit in but had to skip most of them since there was time enough only to attend three a day.

I'm surprised by the strength of localization and translation companies among those who rented a booth in the exhibition hall. The ones I talked to acknowledged growing competition but also seemed pleased with the direction in which their business is heading.

XML was a big focus area, as evidenced by the opening panel discussion on Sunday evening. All technical communicators need to pay attention to XML's growing footprint in corporate communications.

I've also had the opportunity in this Summit to meet many authors and educators whose work I've known for years but never had the chance to meet in person previously.

Adobe and MadCap as well as AuthorIt were among the corporations who've invested big time in this conference as main sponsors. I assume Adobe has spent a little more than the others as the Platinum Sponsor of the event. The two seminars presented by Adobe's very-qualified R.J. Jacquez were among the best that I've attended during this conference.

Other corporate participants and sponsors of note: TechSmith, DocToHelp, Ken Cook Co., CARA, and Texas Tech Univ. Distance Learning Division.

I'll continue to share the lessons and my impressions of this excellent conference in the days ahead. Perhaps I'll meet you next year down in Atlanta where the 2009 STC conference will be held.

For more info, please visit www.stc.org

Friday, May 30, 2008

STC Annual Conference

I'll be at the STC Annual Conference next week, held in Philadelphia, PA. It's going to be an exciting conference and I'll file my impressions on a daily basis right here.

One issue that I see surfacing these days is the very definition of a "technical writer" since we tech writers usually do a lot more than just "writing." We also design information and do a lot in terms of page layout, graphics, single-sourcing, and illustrations.

So the new term is "technical communicator" but the Labor Department is still resisting the redefinition.

I'm all for the "technical communicator" label since in all honesty we do a lot more than just "writing." Try creating a structured FrameMaker document and you'll know what I mean.

Thursday, May 29, 2008

Writer, 98, Writes His First Novel

This is the sort of inspirational story that I love...

Writer at 98 writes his first novel and starts a memoir: "My First One Hundred years". You gotta love a guy with a sense of humor like that!
http://www.sfgate.com/cgi-bin/article.cgi?f=/c/a/2008/05/28/DD2T10SJEI.DTL

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Osmond Molarsky has been writing all his life. He's written ad copy, radio documentaries, U.S. Navy training films and a series of children's books. But it wasn't until last year that the 98-year-old Mill Valley resident wrote his first novel, a contemporary political satire called "The Noah Hour."

So far, though, no takers. "I've sent query letters to publishers," Molarsky says. "I've tried agents, and they're all looking for 'chick lit.' A lot of them say that right on their resume."

New Technical Writing Info Mail List now available

Are you interested to change careers and become a well-paid and well-respected Technical Writer?

"Technical Writing Weekend Boot Camp" classes are forming. Write your first software manual within 2 days.

I'll be teaching these classes personally. I'm looking forward to share my 10-years Fortune 500 techncial writing experience with all my students.

Class size limited to 15.

Sign up with this info list and receive both information on these classes and free tech writing tips and tutorials.

http://www.learntechnicalwriting.com