Video summary

Usability Heuristic 10: Help & Documentation

Main summary

Key takeaways

Educational

Main ideas / lessons

  • Help & Documentation is Jakob Nielsen’s 10th usability heuristic.
  • Even if UX is designed to be intuitive, users will sometimes need help, especially as interfaces become more complex (e.g., many possible gestures in mobile apps).
  • Help/documentation can take many forms—not just traditional help pages:
    • Onboarding
    • Walkthroughs
    • Tooltips
    • Popovers
    • Videos
    • Chatbots
    • Web chat, etc.

What good help should look like

  • Easy to find/search
  • Focused on the user’s task
  • Actionable (includes concrete steps)
  • Timely and scannable (minimize effort and information overload)

Methodology / checklist

When applying the heuristic, consider:

  • Searchability

    • Ask: Is it easy to search for help?
    • Ensure documentation is easy to search (match how users expect search to behave).
    • Use analytics and insights from usability testing to confirm search works as users anticipate.

  • Task focus (relevance)

    • Ask: Is the documentation focused on the user task?
    • Prefer contextual help delivered while the user is performing the task, so it stays relevant and timely.

  • Concrete, step-by-step guidance

    • Ask: Does the help/documentation list concrete steps to be carried out?
    • Provide clear, executable actions (e.g., visually prominent steps, screenshots aligned with instructions).

  • Timeliness + reduced reading burden

    • Since users don’t like reading docs, provide help at the moment users need it (e.g., contextual UI assistance during form completion or actions).

  • Scannability + information control

    • Ensure help has scannable steps.
    • Avoid overloading users with unnecessary information.

Examples mentioned (what they illustrate)

  • LeTote.com

    • Help Center search returns question-form suggestions/FAQs.
    • Results are easy to scan, helping users quickly judge relevance.

  • Wayfair

    • Help search is less effective due to a 30-character limit.
    • Search suggestions are mostly generic pages, requiring extra clicking—raising interaction cost.

  • Skyscanner

    • Provides contextual help via popovers.
    • Shows relevant search options right when the user interacts with the destination field.

  • Asana

    • Help pages include interspersed screenshots with visually prominent steps, making instructions easier to follow.

Speakers / sources featured

  • Jakob Nielsen (referenced for “10 usability heuristics,” specifically Heuristic #10)
  • Websites/products used as examples:
    • LeTote.com
    • Wayfair
    • Skyscanner
    • Asana

Original video