Page MenuHomePhabricator

Share what tooltips and pop ups we display in the app and when they are displayed
Closed, ResolvedPublic

Description

Background

Historically as the Android team rolls out new features we add tool tips and onboarding on a feature by feature basis. At times the tooltips can conflict with each other and there hasn't been deliberate thought recently on how we would like to guide users through different experiences within the app. Through this project we will take stock of our current guidance and onboarding to create a comprehensive workflow.

The Task
Review our code to share when we see what tooltips and pop up prompts

Must haves

  • A list of our current tooltips and pop up prompts and when they are triggered written in a way easy for the PM and Designer to comprehend

User Stories

As the PM for Android, I want to know what tool tips or pop ups exist in the app and when they are triggered, so that I can understand the current user journey and map a new one

Design

N/A

Event Timeline

Tooltips

1. Edit notices

when: "Show edit notices automatically" is off.
times: 1 time.

Screenshot_20220217-151457_Wikipedia Dev.jpg (2×1 px, 500 KB)


2. Search tab

when: navigate to the "Search" tab.
times: 1 time.

Screenshot_20220217-151919_Wikipedia Dev.jpg (2×1 px, 218 KB)


3. Edits tab

when: not in the "Edits" tab and must have visited the Explore feed more than 2 times.
times: 1 time. (for both logged-in and non-logged-in users).

Screenshot_20220217-152816_Wikipedia Dev.jpg (2×1 px, 739 KB)


4. Customize toolbar

when: after staying 2 seconds in the article screen. It has a lower priority than the Watchlist tooltip.
times: 1 time.

Screenshot_20220217-153043_Wikipedia Dev.jpg (2×1 px, 872 KB)


5. Notification

when: logged in and visit the article page at least once.
times: 1 time.

Screenshot_20220217-160154_Wikipedia Dev.jpg (2×1 px, 819 KB)


6. Multilingual onboarding in Search

when: only one app language.
times: 1 time.

Screenshot_20220217-160903_Wikipedia Dev.jpg (2×1 px, 307 KB)


7. User stats in Edits screen

when: long press on stats views.
times: show when long pressing on the view.

Screenshot_20220217-161054_Wikipedia Dev.jpg (2×1 px, 337 KB)


8. Watchlist tooltip on the main screen

when: watchlist tooltip on article screen has shown and logged in.
times: 1 time.

Screenshot_20220217-161606_Wikipedia Dev.jpg (2×1 px, 698 KB)


9. Watchlist tooltip on article screen

when: logged in and has visited article screen for at least 3 times, and the entry point was not from Suggested edits.
times: 1 time.

Screenshot_20220217-161602_Wikipedia Dev.jpg (2×1 px, 725 KB)


10. Sequential user stats tooltips in Edits screen

when: the total contributions are greater than zero and logged in.
times: show the tooltips for each stat sequentially.

Screenshot_20220217-162040_Wikipedia Dev.jpg (2×1 px, 383 KB)

Dialog

Announcement

when: show in either Explore feed or article screen, depends on the date and type.
times: 1 time.

fundraising-article-2019.png (1×720 px, 341 KB)


Prompt enable sync

when: logged in

  • scenario 1: first time attempting to sync, and the syncing isn't enabled on the server.
  • scenario 2: in the Reading list screen and the user added or deleted articles to the reading list, and the save count is not more than 3.

times: keep showing until the user disables the prompt.

Screenshot_20220218-173506_Wikipedia Dev.jpg (2×1 px, 311 KB)


Prompt login to sync

when: not logged in

  • scenario 1: in the Reading list screen and the user added or deleted articles to the reading list, and the save count is not more than 3.
  • scenario 2: user wants to manually sync the reading list.

times: keep showing until the user disables the prompt.

Screenshot_20220218-173551_Wikipedia Dev.jpg (2×1 px, 291 KB)


Edit notices

when: the article contents edit notices in editing screen.
times: keep showing until user disables the prompt.

Screenshot_20220218-174158_Wikipedia Dev.jpg (2×1 px, 451 KB)


Logged out in background

when: user has been logged out in background.
times: every times when being logged out.

Screenshot_20220218-174821_Wikipedia Dev.jpg (2×1 px, 575 KB)


Remove Chinese variant prompt

when: in Explore feed, if the user has both Traditional Chinese and Simplified Chinese in app languages.
times: 1 time.

Screenshot_20220218-173727_Wikipedia Dev.jpg (2×1 px, 308 KB)


Protected in Gallery

when: click on the edit pencil in Gallery and the image is protected.
times: every time when clicking on it.

Screenshot_20220218-173755_Wikipedia Dev.jpg (2×1 px, 567 KB)


Reverted description edit

when: if we open a new page that that contains a revert qnumber parameter.
times: when opening a tab with revert number.

Screenshot_20220218-174410_Wikipedia Dev.jpg (2×1 px, 429 KB)


Verify before editing description

when: not logged in and the total anonymous descriptions editing is more than 5, and the prompt is leading the user to the login page.
times: every time when reaching the condition above.

Screenshot_20220218-174123_Wikipedia Dev.jpg (2×1 px, 611 KB)

Hi @JTannerWMF, the task is completed. Please verify the descriptions and screenshots above, and let me know if you have any questions!

Thanks @cooltey , this is very helpful. Is this also the order or do we have logic of what order users see these tooltips from the moment they download the app for the first time. Let me know if this question makes sense.

Per discussion in task sync @cooltey @JTannerWMF

  • can we add all instances of full screen onboarding to the task? (e.g. app onboarding, onboarding when editing the first article description. image tags in suggested edits, etc.
  • also onboarding cards (like in the explore feed, within reading lists or suggested edits [when not logged in]) would be helpful

thanks!

Onboarding

Welcome

when: new install
times: 1 time

Screenshot_20220301-124209_Wikipedia Dev.jpg (2×1 px, 242 KB)


Customize your Explore feed

when: new install
times: 1 time

Screenshot_20220301-124231_Wikipedia Dev.jpg (2×1 px, 365 KB)


Sync reading lists

when: not-logged-in user
times: keep showing until logging in or dismiss it manually

Screenshot_20220301-124304_Wikipedia Dev.jpg (2×1 px, 333 KB)


Turn on sync reading list?

when: logged-in user and sync reading lists setting is off
times: keep showing until enabling it or dismiss it manually

Screenshot_20220301-124939_Wikipedia Dev.jpg (2×1 px, 242 KB)


Did you know everyone can edit Wikipedia?

when: not-logged-in user
times: keep showing until logging in

Screenshot_20220301-124319_Wikipedia Dev.jpg (2×1 px, 295 KB)


"Happy editing" welcome message

when: logged-in user with zero contributions
times: keep showing until made a first edit

Screenshot_20220301-124425_Wikipedia Dev.jpg (2×1 px, 341 KB)


Tagging images make them easier to find

when: first time entering the Image tag in Edits
times: 1 time

Screenshot_20220301-124436_Wikipedia Dev.jpg (2×1 px, 208 KB)


Article description

when: first time entering the article description from article page
times: 1 time

Screenshot_20220301-124457_Wikipedia Dev.jpg (2×1 px, 219 KB)


Article description published

when: after publishing the first article description
times: 1 time

Screenshot_20220301-124549_Wikipedia Dev.jpg (2×1 px, 351 KB)

Hi @JTannerWMF @scblr

Here's a diagram that shows the orders of tooltips/onboarding/dialogs. Please note that it does not include some "click-event" base dialog such as the "Protected in Gallery" dialog.

Please let me know if you have any questions.

Tooltip.drawio.png (1×1 px, 147 KB)

Thanks @cooltey — your work will be essential for T301397. Looking forward to get started with it soon! 🚀