Nuance.com authoring guidelines

Organization and flow

Headlines, links, and lists

Whether you're writing a gateway page, a solutions page, or a campaign page, it's important to organize the page so that it flows as a whole and helps readers quickly find what they need. Creating a good user experience requires thoughtful consideration of formatting and dividing content so that your page tells a cohesive and engaging story.

Headlines

Keep context in mind

On a web page, it’s important to consider both the content of your headline but the context in which it exists. Ideally, headlines speak not only to the content they head but also to the headlines around them, insofar as they divide information into discrete buckets and create a hierarchy of content for the reader to follow. A quality headline hooks readers into the specific value of its own content while establishing its place in the hierarchy of the page and differentiating itself from the headers that surround it.

Headline length

Remember that your headline is the hook for the content it heads: it must create interest and excitement in that content without summarizing or replicating it. If a page’s headlines lose readers’ interest, they will disengage from the content and leave the page. With this in mind, be sure to make your headlines as short, specific, and intriguing as you can, ideally keeping to one line and never extending beyond two.

Don't:

Dragon Medical One helps you automate time-consuming tasks with advanced speech recognition

Be informative and succinct

Communicate what's in it for the reader rather than delivering an overview or synopsis.

Don't:

Dragon dictation solutions can be locally installed or cloud-native

Choose specificity over vagueness

Vague, unsubstantiated claims read as insincerity. It's always better to communicate the unique value of your product or offer rather than reaching for superlatives that sound impressive.

Don't:

Hard-working strategies for solutions that work hard

Key considerations

  • Think carefully before writing a headline without verbs.
  • Keep headlines to a single sentence.
  • Never use an exclamation point in a headline.
  • SEO is important in headlines, but it should never be prioritized over clarity and conciseness.
  • Don’t waste characters on repeating the product name or citing Nuance in a header on a Nuance solutions page.

Lists

Legibility over longform

When you have a series of steps, benefits, or features you want readers to absorb, it is better to single them out in list form rather than lumping them in a longform paragraph.

Don't:

Your one-time implementation fee includes verification of Dragon Medical One installation, application of custom settings and extensions, voice profile setup and configuration, and guided pairing with PowerMic Mobile.

Why?

Whether calling out benefits that differentiate a solution or features that customers are paying for, it is more legible to separate them into bullets than lump them together in a long-form paragraph. Not every series of qualities or characteristics deserves a list, but if you are cataloguing important assets that you want readers to absorb, a list is more likely to achieve your purpose.