Sofa's blog about design, code Ampersand everything else.

« Previous Stopped at Every Turn Tuesday the 14th of July, 2009 Welcome Window Next »

Writing for The Web 

by Jens Hollander

Writing text for the web isn't that hard. Here are the 10 rules I follow to help me write clean, comprehensible text for the web.

As a freelance writer I've been helping Sofa create, design and restyle websites. Since I've been spending so much time with them I thought it would be fun to add something to the Sofa blog.

One of the most annoying things on the web are pages filled with text and different pages that require endless clicking, scanning and more clicking to find what you need. Text for the web should be clearly set out so the reader is able to scan through it quickly and easily. Just like the interface, it should be intuitive to find what you are looking within the text. To do this, I follow these 10 rules:

1. Know the Product you're Describing

“The options are limitless.” You find such phrases on many a webpage. I always get the feeling that the writer just doesn't know exactly what their product does and so they resort to hollow sentences like this. Before doing any work, describe for yourself in a few sentences what the product does. Don't talk about the competition or talk about things your program doesn't do. Just describe what it does, plain and simple.

2. What Problem Does It Solve

We buy new products or software because they fill needs we either have, or think we have. A good understanding of what need the product fills or which problem the product solves is the most vital aspect to writing good text for the web.

3. Break up All the Text

You know what the product is and what it does. Now write a list about all the things you want to tell about the product. What features do you want to highlight, what are the ways people can use the product? I begin by creating an outline of all these points. In the final text they will become small columns of text. It helps me while writing it and it will help the reader find what he or she is looking for when reading it. This is the setup I used in a recent project, an online web service:

  • A short description of the product and the problem it solves.
  • A short, but more in-depth, look at the features of the product.
  • Special features that set it apart from the competition.
  • A bulleted list of other cool features.
  • The real world. Who would use the product, what benefit would they have?
  • How does it works with other programs? How can you export your data?
  • What does the company do to keep your online data safe?
  • What does the company do to safeguard your privacy?

4. Write a First Draft As Quickly As You Can

Now it's time to get the first draft done as quickly as you can. Don't worry about grammar, spelling or even making sense, there's plenty of time for that later on. Just get it out of your system.

5. Writing Is Rewriting

I know it's a cliche, but that's only because it's true. Rewriting is the only real thing that sets the professional apart from the amateur. A professional is simply an amateur who didn't give up. Most word processors can count words for you, use this feature to keep all of the columns roughly the same size. Expand or increase text where needed. When you're done, print out your text and read it, away from your screen. Make notes about anything that's wrong with it. Rewrite the text on your computer, print it out a second time and go over it in the same way. Repeat, go home for the night and repeat the following morning.

6. Love the Designers and They Just Might Love You Back

When you have something close to how you think it should be, talk to the person who is designing the page. At Sofa, I've spent hours sitting besides Joy-Vincent talking about how to design the webpage. I told him how many columns I think I would need and what the subject was of each column. He told me what visual features he wanted to put in his design. Together we came up we a plan on how both our work would complement each other's.

7. Don't Do Your Own Proofreading

By this time, you've gone over it so many times that your eyes glare over broken sentences and weird spelling. This would be a great time to let someone else read the text. Don't make your designer do this, you've been a pain in his or her butt already. Find someone who isn't involved with the project. If they read it and don't understand it, you know you're not done.

8. Let the Client In

It's a hard thing to keep the client in the dark for so long, but now you really have something to show them. Let them read the text, ideally in a basic set-up of the website. If you give them your work in a text document it becomes clear just how few words go on a good website. A text written for the web only really works on the web. When talking to the client, have a pen and paper with you and write down all their remarks. If they come with something you don't agree with, write it down extra clearly. They probably know more about the product and their intended audience than you do. If you really don't agree with them, politely explain why you did what you did. Always be ready to change it. You can work on your own novel at night.

9. Did I Say Love Your Designer?

If the client is happy with the copy it's time for the designer to make up the final design. Try to be involved in this. Take a look at the work in progress, take out a few words here, add a few words there. If it makes the pages looks better it will make your text look better.

10. Know When to Quit

Reaching the end of a project always comes with some frantic late-night shifts to make the deadline. Avoid making drastic changes in this part of the process. You've been staring at your own text for so long that you probably want to change it just to look at something fresh. Don't do this. This is the part where any mistake can have severe consequences. Just do as little as possible and enjoy seeing your original text come to life on a beautiful website.

These are some of the rules I follow when writing web text, a craft which I'm learning more about about each day. If you have any good tips, drop me a line at hollander@mac.com.

 

This is an archived version of the Sofa site