Create Onboarding for Patroller Tasks
Closed, ResolvedPublic

Assigned To
Authored By
JTannerWMF
Aug 1 2023, 3:45 PM
Referenced Files
F38610229: tooltip.png
Oct 18 2023, 3:27 PM
F38610224: Screenshot 2023-10-18 at 16.12 1.png
Oct 18 2023, 3:27 PM
F38609976: Group 5558.png
Oct 18 2023, 3:27 PM
F38536675: Screenshot_20231017-170048_Wikipedia Dev_new.jpg
Oct 18 2023, 12:06 AM
F38536676: Screenshot_20231017-170036_Wikipedia Dev_new.jpg
Oct 18 2023, 12:06 AM
F38449734: 3.png
Oct 16 2023, 6:07 PM
F38449730: Onboarding 4.png
Oct 16 2023, 6:07 PM
F38215329: 3-1.png
Oct 12 2023, 10:42 AM

Description

Background
Android users with extended rights (Sysops and Rollback), will have access to a patrolling feature in the app. With it being a new feature, we will want to onboard them to it.

Requirements

  • Full page onboarding shouldn't exceed 2 screens
  • Onboarding should inform users who to report issues, and that they have the ability to store warning messages
  • Onboarding should be initiated the first time a user clicks on the Patroller Task card in Suggested Edits
  • Copy should be translated to Indonesian

Designs
Figma file

1. New card in 'Edits'2. Onboarding modal 13. Onboarding modal 24. Onboarding modal 35. Tooltip 1 - diff view6. Tooltip 2 - diff view7. Feedback form8. Add feedback9. Submit feedback10. Feedback submitted confirmation toast11. Tooltip 3 - submit more feedback
Suggested edits.png (360×720 px, 43 KB)
Onboarding modal 1.png (360×720 px, 30 KB)
Onboarding modal 2.png (360×720 px, 38 KB)
Onboarding 4.png (360×720 px, 22 KB)
3.png (360×720 px, 39 KB)
3-1.png (360×720 px, 39 KB)
Feedback modal 4.png (720×1,440 px, 72 KB)
Feedback modal 2.png (720×1,440 px, 65 KB)
Feedback modal 5.png (720×1,440 px, 72 KB)
Confirmation toast.png (720×1,440 px, 75 KB)
Tool tip to submit feedback.png (720×1,440 px, 83 KB)

1 . Similar to other 'Suggested edits' cards the 'New' shows up when the feature is added.
2 . - 4. Onboarding modals show up when the patroller taps on 'Edit patrol' card for the first time only. The third onboarding screen asks people if their data can be collected for this feature.
5 . & 6. Tooltips shows up when patroller taps on any diff from the 'List of edits'
7 . Feedback form pops up after a user performs their first action using a toolbar item.
8 . & 9. Asks for feedback only if patroller taps 'Neutral' or 'Unsatisfied' from previous 'Help us improve this feature' modal.
10 . Confirmation toast after patroller submits feedback.
11 . Tooltip explain where patrollers can submit feedback anytime.


APK: https://github.com/wikimedia/apps-android-wikipedia/pull/4208

Event Timeline

Hi @cooltey, just a heads up, I added the third onboarding screen (asking permission to collect data) in this flow.

Hi @OTichonova and cc @JTannerWMF

The third onboarding screen asks people if their data can be collected for this feature.

For the third onboarding, you would like to add a specific data collection toggle for this feature only:

  1. Should we also add it to the "Settings" -> "Privacy" since it is an individual data collection preference?
  2. Do we have the URL for the "Learn more"?
  3. I checked the Figma file and found out the design is different. Which one should I follow? It would be better if we follow the one you paste in the ticket since it has a consistent design.

Another question:
For the tooltip here:

3.png (360×720 px, 39 KB)

Should we update the text since the "Damage" has been changed to "Quality"?
Thanks!

Hi @cooltey, great questions!

  1. I will double check with Jazmin
  2. The URL: https://foundation.m.wikimedia.org/wiki/Policy:Privacy_policy
  3. Sorry about this, not sure which design that is, you can find the same design here

For the tooltip: Yes, thank you for catching this I've updated the screens.

Hi @JTannerWMF

I had a quick question about screen #4 where the user is shown the data opt-in choice. I understand that this opt-in is feature specific. I am a little worried about creating feature-specific opt-ins. They might cause issues like:

  • If we do this with many features it will come with heavy code maintenance, because now before sending each feature specific event, we need to base it on that feature's switch, rather than have any event that goes out of the app be reliant only on app level permission from the user
  • It gives rise to conditions like - what do we do if they choose Not to share at the feature level, but have agreed to share at an app level. Currently the way it is, it will only be sent if we have both permissions. But that would then mean instead of encouraging them to share, we might inadvertently be cause more withdrawals. Whichever way we configure this conditional, we are bound to create confusion.

Please let us know how important this is, so we can keep it simple and have this switch represent the app level permission, but still have the switch screen here so they get a chance to change app level sharing.
Cc @cooltey @SNowick_WMF

Hi @Sharvaniharan @cooltey as it was agreed in todays meeting for screen #4 -> to show the opt-in screen to users who are not opted in already, rather than having this be feature specific.
The design for the onboarding screen and the copy for the first tooltip have been updated.
Thank you!

Hi @OTichonova

The implementation is completed, please download the APK from the ticket description to test it.

If you want to revisit the onboarding screen, tooltips, or the feedback dialog, please go to "Settings -> Developer settings" to enable them.

Screenshot_20231017-170036_Wikipedia Dev_new.jpg (1,080×2,220 px, 342 KB)
Screenshot_20231017-170048_Wikipedia Dev_new.jpg (1,080×2,220 px, 281 KB)

Hi @cooltey!
Thanks, I have a couple of things listed below.

  1. Can we replace the tooltip button for Quality to be 'Next' rather than 'Got it'?
Group 5558.png (692×937 px, 166 KB)
  1. In the case that someone chooses to watch a page as their first action, they tap on 'Watch' and then would it be possible to withhold the feedback modal to pop up until the contributor finishes changing the watchlist expiry time? It feels a little abrupt that when you tap 'Change' (from the toast) the feedback screen pops up. Video here
  1. The feedback modal pops up after 1 action has been completed. One can tap out and close down the modal by tapping outside of the modal, then the modal pops up after you complete another action and so on. Can we prevent contributors closing the modal by tapping anywhere else on the screen? So they have to complete the flow for them to move forward and not trigger the modal again and again afterward? Video here.
  1. Can we change the last tooltip to say 'Tap on overflow menu to submit feedback anytime under 'Problem with feature'. & a 'Got it' button.
CurrentChange to
Screenshot 2023-10-18 at 16.12 1.png (448×934 px, 154 KB)
tooltip.png (221×180 px, 8 KB)

Thank you!

Hi @OTichonova,

Hi @cooltey!
Thanks, I have a couple of things listed below.

  1. Can we replace the tooltip button for Quality to be 'Next' rather than 'Got it'?
Group 5558.png (692×937 px, 166 KB)

Yes and done!

  1. In the case that someone chooses to watch a page as their first action, they tap on 'Watch' and then would it be possible to withhold the feedback modal to pop up until the contributor finishes changing the watchlist expiry time? It feels a little abrupt that when you tap 'Change' (from the toast) the feedback screen pops up. Video here

Yes, it makes sense to me. I have added an extra logic to showing the feedback form for the watchlist:

  1. The feedback form will show up after the snackbar with "Change" dismissed.
  2. The feedback form will show up after the watchlist expiry bottomsheet is dismissed.
  1. The feedback modal pops up after 1 action has been completed. One can tap out and close down the modal by tapping outside of the modal, then the modal pops up after you complete another action and so on. Can we prevent contributors closing the modal by tapping anywhere else on the screen? So they have to complete the flow for them to move forward and not trigger the modal again and again afterward? Video here.

Yes and done!

  1. Can we change the last tooltip to say 'Tap on overflow menu to submit feedback anytime under 'Problem with feature'. & a 'Got it' button.
CurrentChange to
Screenshot 2023-10-18 at 16.12 1.png (448×934 px, 154 KB)
tooltip.png (221×180 px, 8 KB)

Thank you!

Done!

Please download the APK from the ticket description to see the changes, thank you!