Focus on Web Writing

Moving: The Cat’s Meow

When you help me downsize my house, a hungry kitten gets fed.

 

That’s right, I’m aligning with the BC SPCA (Vancouver) to ensure the contents of my house are sold and I can move to a smaller living space. In the process, I’m donating a portion of the sale proceeds to the SPCA.

 

There’s a showing at my house this Sunday afternoon (Dec. 9) from 2 to 5 pm.
See what’s for sale.

 

What’s in it for me? I get to share in the spirit of Christmas.

Moving: When a raven is like a writing desk

Moving house is always mad, mad, and more mad. And this move is the maddest of all. This is the big downsize move in which I turn a three-story house into a one-bedroom condo.

Downsizing

To that end, I have a vast number of things to divest myself of (ranging from appliances and antiques to curios and gardening tools). With Christmas just around the corner, I’d like to view this more as an opportunity to make some important changes in my life in a way that benefits others. So, instead of a personal liquidation sale, it’s my way to lighten my load—a bourgeois potlatch, so to speak. Some items I’m selling, some I’m asking you to donate to a local charity, and some I’m giving away.

 

 

Doing the Right Thing

Yesterday, I toured the Basilica de Saint-Denis in the Paris suburb of the same name. Why, on my first day in Paris, I would visit the suburbs may be a mystery to some, but I wanted to start at the beginning and in terms of basilicas and Paris and indeed France, this is where it all begins. Saint Denis is the patron saint of France and his remains are interred here along with those of a great deal of France’s royalty from Dagobert to Marie-Antoinette.

I started in Saint-Denis not just to see the gothic church that inspired all others—Saint-Denis’s firsts include its beautiful rose windows, and its pointed arches—but I think there’s an anti-revolutionary spirit in me. I know that revolutions never replace an ancien regime with anything better, if the revolutionaries do not live the qualities they aspire to. It’s always an inside job. Gandhi had it right.

Over the last few months, I’ve been given the opportunity to place my values in front of my needs and am the better for it. There is a business application for this that I embrace—it has to do with doing what’s right. Here are three examples:

  • At the tail end of a contract, my manager was let go and I ended with four days of my time owing to the company. Later, the replacement manager asked me if he could hire me back. This is common sense, but while I could have signed a new contract and never mentioned the four days owing (nobody but me would have known), I offered up my four days. As the new manager didn’t know what sort of budget he had, this was enormously helpful, and later paved the way for him to hire me back for an additional four-month contract. Honesty is its own reward.
  • Likewise, I quoted 24 hours to a client to copy edit his 30-page financial report. I must be getting good at copy editing because the entire job (including the copy edit and designing a new template and style sheet), took me only 6 hours. With the previous example of integrity in my head, it was easy to ignore the little devil on my shoulder and bill only my working hours, not the proposed contracted hours.
  • Finally, a fellow musician in Montreal put out a panicked message to all her clarinet-playing colleagues on facebook for a certain part of music she needed. I responded that I was too busy packing for my trip to help her. During the day though, I kept thinking about that rare clarinet part and gradually found that it was easy to locate it in a box of my music, scan the section she wanted, optimize it into a compressed PDF, and finally post it to my site where she could download it.

The fascinating part for me was not that I did these things, but that they got done simply by me not resisting their accomplishment. I under-promised and over-delivered.

Basilica Saint-Denis

Where it all begins

Communication – How to Keep your Clients Happy

I sit in cafés watching the patrons tapping away at their laptops or PDAs and wonder how many of them are billing hours for their labours. If they are, I also wonder how they maintain communication with their clients. Are they off in a dream of worker freedom or are they providing value for their clients at least as effectively as if they were in the corporate office?

Having worked from home as both employee and contractor, I know that the only way it can be effective is if I can ensure that the trust between me and my clients (boss) is rock solid. How I do that is through communication. Below are some of the communication tools I’m using:

Skype Skype is a software application that allows users to make voice calls over the Internet. It’s one of my favourite tools—so much so that I often use it during business hours in Vancouver to save my cell phone minutes. Last year, when I was in Portugal, I found that the Skype connection on my iPod (needs WiFi) was better than on the laptop.
Google Talk Google Chat is good because your clients can contact you on a moment’s notice (provided you both have it open). By seeing I’m online and available, my clients can have the assurance that I’m working on their projects, etc. etc.
Cell Phone Want to run your laptop and phone abroad and not sure what to do? I was in Foreign Electronics the other day picking up a power adapter and they advised me to remove the SIM card from my phone on arrival in France and just use my phone for WiFi only. I’ve already ensured that all the hotels where I’m staying have WiFi, so if I need to talk, I can use Skype. If I want a cell phone, I can pick up a local SIM card (check that your phone accepts one – my iPhone 5 doesn’t).
Web Texting Most cell providers, such Roger’s, allow you to send and receive text messages through their web site free. So, if you’re working very remotely from, say, the south of France, you’ll want to keep your texting as low cost as possible.

It’s a Digital Life – Writing for the Web

When writing a blog (or any type of web writing), you are writing for an audience that’s fickle and distracted. There’s just too much information, so they flit about and if they encounter a problem (such as poor organization, or rambling writing), they bail. Web readers will not read your writing, unless it is written to their needs.

Web readers read differently:

  • They don’t read screens as easily as pages.
  • They tend to scan and forage for the content they want.
  • They don’t read in a linear fashion—they follow links and move about.

The general rule for web writing is to write shorter sentences, but little information is ever provided on how to write shorter sentences. The old maxim, ride the horse in the direction it’s headed, is appropriate here. If you organize your information in a way that follows how people read, your blog is more likely to be read.

Writing a corporate blog

I recently wrote a corporate blog and came upon some interesting considerations. It’s one thing to write a blog for one’s own site, but to write on behalf of someone else (i.e., a company) is another matter. There’s of course the matter of style and tone, but what is appropriate especially if there are no clear guidelines.

You may have to spin things slightly to represent the best interests of your employer, but don’t be insincere—people sense it. The story I wrote, Iridium satellites not affected my recent solar storms, concerned the effects of recent solar storms on the company’s GPS location-based tracking services. I realized that it was important not to represent their technology as vulnerable or the solar storms as alarmist.

Here’s what I came up with:

  • Focus on the positive – plays down concerns in the title
  • In first sentence, I use end focus to draw attention to reliability of products/services of company “…has had no affect on Iridium satellites”.
  • I chose a beautiful and re-assuring image of the aurora borealis, instead of something that might cause concern.
  • I was given permission to use images found on the internet (always something to consider), but because I didn’t think the site where I found this image was one I wanted to highlight, I buried the source credit in the code for the image.

Usability Fun and Games

I convinced myself that applying for a job through the IBM web site was a good use of my time, but I didn’t factor in how much fun it would be.

Like many mega corps, the IBM site asks us to upload our résumés and then goes on to ask us to enter all the same information again manually, field by field. By the end, we’re likely to conclude that any job we should ever get at IBM will net us similar mindless work. But who knows, filling out online applications is my form of Vegas—’cause ya’ never know…

Here’s the kicker. In the section for language competency, I was given a list of languages and a ranking system from which to choose: fluent, intermediate, basic knowledge, and no knowledge. I don’t know what the value is in adding information about a skill in which one has no knowledge. I mean, I could go on and on.

I couldn’t help myself, so I obliged!

No Knowledge required

Three Ways to Improve Your (Technical) Writing Skills

I get asked more frequently about how to make inroads into the field of technical writing and my response generally comes down to three key points:

  1. Get educated: Many technical schools and universities have technical writing programs. They often offer their courses on an iterative basis (i.e., you don’t have to commit to the entire program; you can just take a course or two to try it out). Apart from the training you’ll get, formal training is also a great way to network and immerse yourself in the milieu of technical writing.
  2. Get Informed: Check out the job boards and read the requirements for various jobs in technical writing. If you find the requirements daunting—don’t be discouraged. Many job descriptions are little more than wish lists, but they’ll give you an idea about the kind of skills you’ll need to succeed and the range of industries that need technical writers.
    Tip – rather than searching for “technical writer” over a large date range, I view all posted jobs in, say, the last three days. Positions that require technical writing skills are frequently posted under other names than “technical writer”.
  3. Get involved: Find opportunities to write—don’t wait for a paying job. You may want to volunteer with some non profit or other group as a writer just to get experience. Everyone needs good writing and if you can provide it, you’ll start to acquire samples of work (ensure that any freebie work you do comes with the understanding that you’ll use finished writing as samples of your work).
    I volunteer as a writer for the Vancouver Observer (an online magazine) and it is definitely helpful for keeping my writing skills honed as well as for networking.

Some notable Vancouver job boards:

Writing for the Web: Clarity 4/7

Avoid Helping Verbs (Might, May, Would, Should, and Could)

Helping verbs, also called auxiliary verbs, are tricky for two reasons: they can have multiple meanings and those meanings are sometimes a matter of interpretation.

EXAMPLE: “When you complete your timesheet, you should be paid.”

If you insert may instead of should, implies possibility or permission.

EXAMPLE: “When you complete your timesheet, you will be paid.”

Writing for the Web: Clarity 6/7

Check Sentences for Misplaced or Dangling Modifiers

Of all grammatical errors, misplaced and dangling modifiers cause the most hilartity. Let’s face it, they’re just plain fun (as long as it’s not you who writes them). In the words of Groucho Marx, “One morning I shot an elephant in my pajamas. How he got into my pajamas I’ll never know.”

  • A misplaced modifier is confusing because, although the modifier may be correct, it’s modifying the wrong word in the sentence.”We almost ate all the turkey” is confusing because it’s not possible to “almost eat” something. The correction is, “We ate almost all the turkey”.
  • A dangling modifier is confusing because the doer of the action is unclear. “After waiting for three hours, the train left the station.” Who did the waiting—you or the train? It’s not clear.

Another example: “It wasn’t long before the two got engaged, lived in several Canadian cities, pursued their separate career paths and explored their new surroundings while weighing the pros and cons of each.”

What are they weighing the pros and cons of?

  • Their surroundings
  • Their separate career paths
  • Several Canadian cities
  • Their engagement
  • All of the above