Page MenuHomePhabricator

[Engineering Epic] iOS - Image Recommendations - Add an Image main flow and actions
Open, HighPublic

Assigned To
None
Authored By
JTannerWMF
Jan 17 2024, 11:14 PM
Referenced Files
F41826216: Deselecting.png
Feb 9 2024, 11:08 AM
F41826222: Other.png
Feb 9 2024, 11:08 AM
F41826214: Reason.png
Feb 9 2024, 11:08 AM
F41826271: Explore feed.png
Feb 9 2024, 11:08 AM
F41796351: Screenshot 2024-02-06 at 17.47.58.png
Feb 6 2024, 8:57 PM
F41744585: Article page.png
Feb 1 2024, 11:32 PM
F41744454: Goat.png
Feb 1 2024, 11:31 PM
F41744525: Deselecting.png
Feb 1 2024, 11:31 PM

Description

Tasks

  • Create explore feed card - T356811
  • Create a half-sheet resizable view with image rec - T356818
  • Create an article introduction view - T356816
  • Fetch article summary - T356816
  • New feature announcement modal - T358894
  • Create onboarding - T358896
  • Create overflow menu - T358902
  • Open image full screen - T358910
  • Go to the commons page on Webview - T358913
  • Update "Add image details" screen - T358917
  • Data transition to preview - T359225
  • Article preview - T358920
  • Adapt "Edit summary" - T358923
  • Survey view - T358924
  • Empty view - T358926
  • Loading state (simple spinner) - T358927
  • Error/success handling - T358928
  • Accessibility basics - T358930
  • Create POST method for the image rec - T356820
  • Event logging - T358931
  • Create lightweight caching - T358933
  • Display suggestion reason - T360207
Nice to haves
Background

This task is for the designs of Image Recommendations / Add an image on iOS. This does not include the experimental flows for alt-text

Task
  • @OTichonova Create a Figma file and link it to this task with screens that show what happens when users interact with actions that align with the requirements below. Get final sign off from Product and Android Designer before adding screens
  • Engineer - review screens and add any questions or possible constraints to consider on the task
  • Engineer- Add subtask to epic for screens that can start being built now based on wireframes
Must Haves for V1
  • Entry point should reside in the Explore feed (not the first card) and a permanent home based on navigation work
  • There should be a tooltip, notification or some sort of intervention to draw attention to the task for qualifying editors
  • Users should have an option to add a caption and alt-text on the screen but it should not be prompted
  • There must be a way for users to report issues with the feature, it should take them to the support email (pre-populated)
  • Users should have an entry point in the task to the FAQ page (via overflow)
  • There should be some sort of way to ensure users aren’t continuously hitting yes in a short (less than 5s) span of time to guard against bad faith edits
  • There must be onboarding to the feature
  • Users should be able to access full article (via read more) and image metadata
  • Do not allow users to skip without providing some feedback (Yes, No, Not Sure)
  • Preview the edit and provide an edit summary before publishing
  • Selecting No triggers a survey (reasons should have parity with Android)
  • Allow users to zoom/pinch on image
  • Considerations for images running out or task not being available in certain languages
  • Non-intrusive guidance for adding captions and alt-text (can take user out of the app)
  • Accessibility in accordance with WCAG
  • Interface must be translated in target languages prior to release
  • Feature should not be available to users with less than 50 edits in the language they are editing
  • Users should understand how the image was recommended (Parity with Android, Sentence noting whether it's related on Wikidata or it was used in another Wikipedia article)

Nice to Haves

  • Users able to filter by topics
  • Subtle positive reinforcement
User Stories
  • As a Wikipedia iOS app user with a small screen and inconsistent internet, I would like to evaluate images and determine if they should go into an article, to contribute to Wikipedia articles that are in need of more content.
  • When I am using the app, I want to be able to add images with one hand to many articles on my mobile device, so that I can be productive while riding the bus in Bogotà, and listening to music.
Designs

Onboarding and main screen

1. New feature announcement2. Entry point3. Onboarding page4. Custom tooltip 15. Custom tooltip 26. Custom tooltip 37. Add image default screen8. Sheet dragged down9. Sheet full page10. Tapping on 'View article' takes you to article view11. Overflow menu items12.Tapping on the image13. Tapping on the title link takes you to commons14. If there are no more images left
Explore feed.png (667×375 px, 28 KB)
Explore feed card.png (667×375 px, 45 KB)
Onboarding sheet.png (1×750 px, 81 KB)
Article page-3.png (667×375 px, 57 KB)
Article page.png (675×480 px, 162 KB)
Article page-1.png (727×480 px, 164 KB)
Article page-2.png (675×391 px, 116 KB)
Mini sheet.png (667×375 px, 32 KB)
Full page sheet.png (667×375 px, 89 KB)
View article.png (667×375 px, 194 KB)
Overflow menu.png (667×375 px, 108 KB)
Tapping on image.png (667×375 px, 350 KB)
Commons.png (667×375 px, 389 KB)
Article page.png (667×375 px, 14 KB)

1: Appears the first time someone opens that app after the feature has been added. Tapping 'Try now' takes you directly to the image recommendations.
2: Card located below the first card in the explore feed.
3: Appears once after someone opens the feature for the first time.
4 - 6: Show up the first time someone opens the feature. Get re-triggered after someone taps on 'Tutorial' from the overflow menu.
7: Default screen has the sheet pulled up halfway. Text behind the sheet is scrollable. Text inside the sheet is scrollable.
11: Overflow menu items include 'Learn more' that takes you to a FAQ page, 'Tutorial' that re-initiates the tooltips and 'Problem with feature' which opens up an email (you can find the copy below under 'Support email Copy').

Choosing 'Yes' from the sheet

1. Add image details page blank2. Add image details text added3. Preview4. Edit summary blank5. Edit summary added6. Confirmation toast
Add image details.png (667×375 px, 57 KB)
Text added to add image details.png (667×375 px, 41 KB)
Preview.png (667×375 px, 197 KB)
Edit summary.png (667×375 px, 36 KB)
Added edit summary.png (667×375 px, 41 KB)
Confimration toast.png (667×375 px, 95 KB)
  1. When no information is added people may tap 'Next' but it is not progressive.
  2. Once caption and/or alt text is added the 'Next' button becomes progressive.
  3. Edit summary -> 'Publish' is disabled until edit summary is added.

Choosing 'No' from the sheet

1. Modal asking for the reason2. Selecting 'Other'3. Deselecting 'Other'4. Tapping 'Submit' takes you to the next edit
Reason.png (667×375 px, 22 KB)
Other.png (667×375 px, 37 KB)
Deselecting.png (667×375 px, 24 KB)
Goat.png (667×375 px, 91 KB)
  1. People may select multiple options. Tapping cancel takes you back to the image recommendation.
  2. Trying to type a reason automatically selects this option. Deselecting this option grey's out any left over text in the input field.

Choosing 'Not sure' from the sheet -> takes you to the next image suggestion.

Question: We agreed to use the iOS sheet. If we have control over the size of the title, could we have the title size be 'Headline/Bold' and the copy be 'Add this image to the article?'?

Todos
  • Ensure copy is translated (OT)
  • Update FAQ page (JT, AR)

Support email Copy:

Subject:
Issue Report- Add an Image Feature

Body:
I’ve encountered a problem with the Add an Image Suggested Edits Feature:

  • [Describe specific problem]

The behavior I would like to see is:

  • [Describe proposed solution]

[Screenshots or Links]

Todos

Related Objects

StatusSubtypeAssignedTask
OpenNone
OpenNone
OpenNone
ResolvedMazevedo
ResolvedNone
OpenNone
OpenNone
OpenNone
ResolvedMazevedo
ResolvedMazevedo
ResolvedTsevener
DeclinedNone
OpenNone
OpenNone
OpenNone
OpenNone
OpenNone
OpenNone
DeclinedNone
DeclinedNone
OpenNone
OpenNone
OpenNone
OpenNone
DeclinedNone
DuplicateNone
OpenNone
OpenNone
OpenNone
OpenNone
OpenNone
OpenNone

Event Timeline

Hi @OTichonova!
I'm adding the points we raised in planning and some other things that jumped out to us on eng sync:

  • For the "New feature announcement", could it be a half-sheet (like the one we're using on the add an image view)?
  • On item 8 "Sheet dragged down", the smallest sheet is only available on iOS 16 and above. Even so, so far in my investigation, when we configure a smaller sheet size, it automatically always opens on the smallest size. If we can't find a way to open on the half-screen size and then drag it down, and for iOS15, can we have it stop on the half-size? The expanded size works fine.
  • On the survey, can we separate the "Other" field? It's easier for us to build it separately. Also, here the option list is inside a rounded-edge rectangle - is it okay if we do it the same way as in watchlists going all the way through the screen?
    Screenshot 2024-02-06 at 17.47.58.png (532×646 px, 49 KB)

Question: We agreed to use the iOS sheet. If we have control over the size of the title, could we have the title size be 'Headline/Bold' and the copy be 'Add this image to the article?'?

We can do it as a custom text and pin it on top of the sheet, which will have the same visual effect.

Hi @Mazevedo!

I'm adding the points we raised in planning and some other things that jumped out to us on eng sync:

  • For the "New feature announcement", could it be a half-sheet (like the one we're using on the add an image view)?

You mentioned that we would be able to 'prevent the sheet from being dismissed by dragging it down and from being expanded, and it's possible to add the X button like in the original design'. So in this case lets change them, I updated the design to hopefully match what it would look like but let me know if it needs to be tweaked.

  • On item 8 "Sheet dragged down", the smallest sheet is only available on iOS 16 and above. Even so, so far in my investigation, when we configure a smaller sheet size, it automatically always opens on the smallest size. If we can't find a way to open on the half-screen size and then drag it down, and for iOS15, can we have it stop on the half-size? The expanded size works fine.

My only hesitation with taking away the smallest sheet size is that one kind of looses the 'View article' button that is located below the summary especially if the summary is long. You mentioned that you were 'partially confident that we can work with the smaller size in the way you're proposing in the designs; it might require just a little working around, so I think it's worth it keeping this way; if it turns out to be impossible, we can check other possibilities. One option would be to be able to dismiss the modal all the way and have a button that brings it back. We can also test making the view behind it scroll enough to show the button.
This sounds good! Let me know if you manage to implement the work arounds.

  • On the survey, can we separate the "Other" field? It's easier for us to build it separately. Also, here the option list is inside a rounded-edge rectangle - is it okay if we do it the same way as in watchlists going all the way through the screen?

I have updated the designs in the ticket to match the watchlist ones.

Question: We agreed to use the iOS sheet. If we have control over the size of the title, could we have the title size be 'Headline/Bold' and the copy be 'Add this image to the article?'?

We can do it as a custom text and pin it on top of the sheet, which will have the same visual effect.

Okay perfect, thanks!

Thanks!

Seddon renamed this task from Design for Add an Image main flow and actions to [Design Task] iOS - Image Recommendations - Add an Image main flow and actions.Feb 17 2024, 12:04 AM
Seddon renamed this task from [Design Task] iOS - Image Recommendations - Add an Image main flow and actions to [Engineering Epic] iOS - Image Recommendations - Add an Image main flow and actions.Feb 27 2024, 2:47 PM
Seddon updated the task description. (Show Details)
Mazevedo updated the task description. (Show Details)