How to write for the web
5 May 2009
|
Blog |
769 views
More than for other platforms, writing for the web requires the author/blogger to deploy a strategy of multiple platform authoring, where the article, cut of by the reader at whatever length, still has to make complete sense. This means that, as an author, you have to start with the most important bits first, then work your way down.
Directly related to the above is the inverted pyramid, which dictates that the author addresses 'who,' 'when', 'where', 'what' and 'how' in the first paragraph of the article.
Already in 1997, Nielsen wrote a paper on how users read on the web. In short, they found that web pages have to employ scannable text, using:
- Highlighted keywords (hypertext links serve as one form of highlighting; typeface variations and color are others).
- Meaningful sub-headings (not "clever" ones).
- Bulleted lists.
- One idea per paragraph (users will skip over any additional ideas if they are not caught by the first few words in the paragraph).
- The inverted pyramid style, starting with the conclusion.
- Half the word count (or less) than conventional writing.
They found that credibility is important for web users, since it is unclear who is behind information on the Web and whether a page can be trusted. Credibility can be increased by high-quality graphics, good writing, and use of outbound hypertext links. Links to other sites show that the authors have done their homework and are not afraid to let readers visit other sites.
Users detested "marketese" and as web users are busy, they want to get the straight facts.
Writing summaries
The first text in most web and intranet pages should be a summary of 1-3 sentences. The starter-summary has several important functions (adapted from here):
- It shows what your page is about; The summary saves your readers time and
annoyance. - It clarifies your thinking.
- The summary doubles as the text people see in search results.
As a result, criteria for the summary are:
- Clarity, a simple guide to what is on the page.
- Making sense as the first text on the page.
- Making sense alone, if people read nothing else at all on the page.
- Usefulness in search results.
- Short.
Four suggested approaches are:
- The executive summary-summary, a true summary of the entire page's content, similar to the first sentence in a news story.
- The key message-summary, conveying the single most important message on the page.
- The description-summary, the easiest option for the writer, if slightly dull for the reader, it resembles the abstract that precedes an academic article.
- The instructions-summary, explaining when and how the page should be used.
General tips
For the actual writing, a series of guidelines should be taken into account (adapted from here):
- The shorter, the better: Simple, direct language communicates your thoughts more efficiently.
- Active voice: "Do it," don't "will have been done" it. Reserve passive voice for situations where you don't know the subject, such as crime and court reports.
- Strong verbs: The best verbs demonstrate action. If you're writing a string of weak linking verbs, think about the action that's happening in your post, then rewrite a new draft using nothing but nouns and verbs in an attempt to better engage your vocabulary.
- Attribute sources: Attribution brings you credibility.
- Contextual hyperlinking: Online narratives should allow readers to "branch off" and click through to other, more detailed, supporting content, depending upon a reader's level of interest.
Try to link those URLs to the relevant proper names, keywords and phrases. - Use formatting: Break up that boring mass of gray type by using lists, headers, blockquotes, etc.
- Easy to read: No block of text more than five lines on the screen.
- Spell check: With both an automatic checker and a manual re-read.
Similarly, a good overview on what makes a good online story.
Tracking the web
Related, when keeping track of postings from around the blogosphere that relate to your own content or blog, this flowchart can be useful to formulate the right response.
Related posts
- Marina and the Diamonds - The Family Jewels (15 July 2010)
- Building a shared African contact database (22 January 2009)
- Conference blogging and torture (26 April 2009)
- Geeks and car accidents (9 April 2003)
- Strep! (17 February 2008)
- Google maps, Soweto uprisings and Iranian TV (21 August 2007)
- A review of realtravel (19 August 2007)
- PayPerPost: Try to make money with your blog (31 July 2007)
The heat of Thailand 
- One day in Bangkok (27 September 2009)
- Staying in (26 September 2009)
- Walking around Saigon (25 September 2009)
- Trying to get to Saigon (24 September 2009)
- Rainy Hoi An (23 September 2009)
- Dead people (22 September 2009)
- Delectable Hue (21 September 2009)
- Down to Halong Bay (20 September 2009)
- Touring through Hanoi (19 September 2009)
- The crabwalk starts (18 September 2009)
- One more thing... (13 September 2009)
- Chiang Rai and Chiang Saen (6 September 2009)
- Incarnations of a logo (16 August 2009)
- Feedback needed, motherf**kers! (9 August 2009)
- F**king social media (4 August 2009)
- It's mellow in Melaka (29 July 2009)
- Food and fun in Malaysia (26 July 2009)
- Exploring Chiang Mai (15 July 2009)
- Paying good money for a lot of shit (5 July 2009)
- Iranian elections (19 June 2009)
- A quick Bangkok run (14 June 2009)
- Nesting in Chiang Dao (31 May 2009)
- Hashing in the mountains (18 May 2009)
- The times they are a-changin' (15 May 2009)
- Treasure hunt (11 May 2009)
- How to write for the web (5 May 2009)
- Hiep hiep hoera! (3 May 2009)
- Conference blogging and torture (26 April 2009)
- Online altruism (17 April 2009)
- A wet dream come true (15 April 2009)
- A week in Brighton (6 April 2009)
- From Jo'burg to Brighton (31 March 2009)
Who's been sharing the love
Search
Stay in touch
Occupying mindspace
Africa art Delft Flickr London Iran Iraq Hash House Harriers Netherlands war South Africa France Paris Italy Milan photography death love India comic strip blues Persian Poland jazz rock beer bookcrossing Budapest Hungary train food travel Thailand Chiang Mai cats quiz internet poverty television museum music fish development tourism weather Spain beach Japan history gay Australia Ireland Dublin Danube Persia Zambia queen Canada science communism Asia China Serbia Brighton classical music Tanzania Dar Es Salaam Bongoyo Senegal electronica folk animation comedy pop cheese Madness puzzle new wave drama rhythm stop motion Viking Sierra Leone soundtrack summer Eindhoven Ryanair Texas lesbian David Bowie iPad Philippines game art nouveau Belgrade Freetown Sava Gaelic physics










After obtaining an M. Sc in maths, Babak Fakhamzadeh started with an office job at a major blue chip company but soon realised he'd do better on his own. Babak is a traveling web guru with a penchant for doing good and a love for visual and experimental art. Together with Ismail Farouk, he won the prestigious Highway Africa new media award in 2007 for