Poll Guides

      +

      Use the following guidance to write text for a Poll Guide.

      A Poll asks a user for feedback on a numeric scale or with an open-ended text field.

      Guide Name

      Start the Guide Name with Poll -.

      Use the Guide Goal that you identified when writing your Guide Plan to create the Guide Name.

      Acceptable Not Acceptable

      Poll - Playground Feature

      Playground Poll

      Playground Question

      Questionnaire - Playground

      Guide Layout

      Use the following layouts depending on the type of Poll you want to create:

      • Open Text Poll

      • Numeric Rating Poll

      Guide Category

      All Polls must be assigned the Research > Poll Guide Category.

      Guide Settings

      Use the following guidelines for Poll Guide settings.

      Styling

      Use the following guidelines for Styling settings.

      Setting Description

      Theme

      Do not change the Theme for a Poll without a good reason and express permission.

      Step 1 Name

      Adding a name to the Step for a Poll is optional.

      Caret

      Polls do not use a caret.

      Backdrop

      Do not enable the Backdrop for a Poll.

      Close Button

      Enable the Close Button.

      Dimensions

      You should not need to change the default Width dimension for a Poll.

      ARIA Label - Accessible Name

      Use your Guide Name to provide an accessible name for the Poll. For example, Playground Feature Poll.

      Role

      Leave the Role as Dialog.

      Autofocus this step

      Leave Autofocus this step enabled.

      ARIA Label - Close Button

      Leave as Close.

      Location

      Use the following guidelines for Location settings.

      Setting Description

      Position On Page

      Set to Bottom Right Aligned.

      If you really want to emphasize a Poll, Centered is also acceptable.

      Anchor To Element

      Do not anchor a Poll to an element.

      Page Location

      Set according to the needs of the Poll.

      Usually, this should be Only on this page.

      Some Guides may need to be displayed Sitewide.

      Activation

      All Polls should be set to activate Automatically.

      Guide Content

      Use the following guidelines for developing Guide content.

      Titles

      The main title for a Poll can be either How did we do? or What do you think?

      Titles must be in bold.

      Subtitles

      In the subtitle for a Poll:

      Description Do Don’t

      Write the subtitle as a specific question, asking the user to rate or provide specific feedback.

      How would you rate the Playground?

      What did you think of the new Import experience?

      Please provide a rating.

      Let us know how we did.

      Rate your experience?

      Write in sentence case.

      What did you think of the new Query Workbench?

      How Would You Rate The New Data Tools?

      Write subtitles in bold font.

      How would you rate the Data API tutorial?

      How would you rate the Data API tutorial?

      Don’t use any other punctuation aside from a question mark.

      How would you rate the new Connect page?

      How would you rate the new Connect page for SDKs, Couchbase Shell, and Import and Export tools.

      We want to hear from you!

      Hint Text

      Hint text provides guidance on what the user needs to enter or what they’re selecting on a Poll.

      Don’t change the default hint text for a Poll guide.

      Action Button

      The action button for a Poll guide should always be Submit Feedback.