Web Writing That Works!

           A Project of
           The Communication Circle

Guidelines Rants Patterns Poems Services Classes Press Blog Resources About Us Site Map

HomePatterns > How to write FAQs > Handle branching with bullets


Why bullets?

Why IF?

Handle branching with bullets

Occasionally, you reach a decision point. The guests should do X if they want to print, Y if they want to save.

OK: the step should read something like this: "Decide what you want to do now." Then drop in two bulleted items:

  • If you want to print, do X.
  • If you want to save the file, do Y.

In this way you bring the decision to the attention of the user, which is good, because many users don't realize they have to make a choice. A decision is a meaningful action; it deserves its own step.

Why bullets?

Putting the options in separate paragraphs clarifies that there are several options, and you can pick one.

Why IF?

Beginning each one with an If clause helps the user decide whether that particular option applies or not.

If it doesn't, the user can skip to the next item.

In this way, you avoid the peculiarly American problem, where people read an item such as "Do X if you want to print," and--right away--they press X right away, even though they do not want to print, because, well, they just act before they read the whole line.

Starting with the IF clause helps make sure they make the right choice...before they act.

Related article

Writing in a genre (Full chapter from Hot Text, in PDF, 770K, or about 13 minutes at 56K)

Answers to Frequently Asked Questions (FAQs) from Hot Text, Web Writing that Works (PDF, 995K, or about 18 minutes at 56K)

Hurray for FAQs (PricePoint)

What are my options?


Home | Guidelines | Rants | Patterns | Poems | Services | Classes | Press | Blog |
Resources | About Us | Site Map

Web Writing that Works!
  2002-2004 Jonathan and Lisa Price
The Communication Circle
Discuss at HotText@yahoogroups.com
Email us directly at ThePrices@ThePrices.com
Order Hot Text (the book) from Amazon