Page MenuHomePhabricator

Onboarding to machine-assisted article descriptions
Closed, ResolvedPublic

Assigned To
Authored By
scblr
Mar 6 2023, 10:16 AM
Referenced Files
F36938227: Screenshot_20230403-190201.png
Apr 3 2023, 5:10 PM
F36938222: Screenshot_20230403-190146.png
Apr 3 2023, 5:10 PM
F36932394: Screenshot_20230329-135754.png
Mar 29 2023, 6:21 PM
F36932412: illustration-ai-article-descriptions.svg
Mar 29 2023, 6:21 PM
F36932390: Screenshot_20230329-135708.png
Mar 29 2023, 6:21 PM
F36932389: Screenshot_20230329-135955.png
Mar 29 2023, 6:21 PM
F36904950: illustration-ai-article-descriptions.svg
Mar 10 2023, 12:17 PM
F36904960: AI art desc 04.png
Mar 10 2023, 12:17 PM

Description

Background

With the addition of machine-assistance descriptions for articles, we need to ensure that the current onboarding experience is still accurate.

The task

  • Ensure that the experience from the two entry points (Article and Suggested edits) is consistent
    • Suggested edits currently have no onboarding
    • Interface consolidation when coming from the article and Suggested edits, e.g., the top part of the edit screen does not exist when coming from an article. This should be consolidated.
  • Ensure that the onboarding illustrations are accurate
  • Consider adding an onboarding slide or integrating info about machine assistance into existing slides

Designs (Figma)

Slide oneSlide twoSlide threeTooltip
AI art desc 01.png (1×720 px, 106 KB)
AI art desc 02.png (1×720 px, 89 KB)
AI art desc 03.png (1×720 px, 87 KB)
AI art desc 04.png (1×720 px, 79 KB)
  • Slide one and two stay the same
  • Slide three introduces machine suggestions
  • Illustration:
    • Uses a linear gradient with the primary and progressive color group
    • Download see attachment [1] below
  • Copy:
    • Title: Machine suggestions
    • Description: The suggestions are generated by a machine, not volunteers or the Wikimedia Foundation.

Attachments

[1]

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

Event Timeline

scblr updated the task description. (Show Details)
scblr updated the task description. (Show Details)

@JTannerWMF could you review the suggested copy for the third slide so it’s aligned with the legal requirements? 👇

Title: Machine suggestions
Description: The suggestions are generated by a machine, not volunteers or the Wikimedia Foundation.

Thanks! ✨


Notes from design review

  • Feedback is generally positive about the project and its explorations.
  • There is discussion about the language used to describe the machine-generated suggestions, with suggestions to use "machine-suggested" instead of "AI" or "algorithm".
  • Consistency in terminology and iconography is important across different applications.
  • Some suggest using a more descriptive label for the source of the suggestions rather than emphasizing that they do not come from the Wikimedia Foundation.
  • There are some questions and suggestions about the implementation of the article descriptions, including using Wikidata descriptions if available and tailoring images to the content of the screens.

Recommendations per design review

  • Use "machine suggestions" to be consistent with other platforms/use cases on Wikipedia
  • Does the copy really need to mention "not by volunteers or the Wikimedia Foundation"? Or could we emphasize the origin of the suggestions, like "The article description suggestions are generated by a machine?"
scblr renamed this task from Review onboarding to machine-assisted article descriptions to Onboarding to machine-assisted article descriptions.Mar 10 2023, 2:16 PM
scblr updated the task description. (Show Details)

Slide 3 and Tooltip should only be shown to users that will see suggestions. Just wanted to explicitly call tha tout

Thanks @Sharvaniharan for helping me access the dev tools and to load the build on my device!

Here are a few small tweaks:

ScreenshotNotes
Screenshot_20230329-135955.png (2×1 px, 159 KB)
Looking at the mock in the description, it looks like the 'By starting I promise not to misuse this feature' line should be removed from this screen.*
Screenshot_20230329-135708.png (2×1 px, 71 KB)
On non default modes the cropping of the illustration only for the third image is larger than the first two, would it be possible to remove the white left and right padding? I've created a quick version of a cropped version of this illustration that could be used for now:
Screenshot_20230329-135754.png (2×1 px, 109 KB)
It appears that button color text on black/dark mode is off for the machine suggestions button

*@scblr not sure if you'd like this added to the third screen instead?

Thanks @Sharvaniharan for helping me access the dev tools and to load the build on my device!

Here are a few small tweaks:

ScreenshotNotes
Screenshot_20230329-135955.png (2×1 px, 159 KB)
Looking at the mock in the description, it looks like the 'By starting I promise not to misuse this feature' line should be removed from this screen.*

I feel this might be as intended as @scblr has mentioned in the task desc that the first two slides should not be modified. @JTannerWMF could you please confirm?

Yeah I think Robin intended for this to be the same as what we have currently

Fantastic, then please disregard! My apologies! Just checking against the mocks :)

Hi @cmadeo

Thank you so much for the review. I have made the changes you suggested. Please check this and lmk if it looks good :
https://drive.google.com/file/d/1wyTlzu5f5EXtKA-y3PKbNWtXjtf2VnYJ/view?usp=share_link

This is now available on alpha and to aid in testing refer to Developer preferences that will help you test: section of https://phabricator.wikimedia.org/T333733

Great work @Sharvaniharan – only one small change:

1) The text "By starting, I promise not to misuse the feature." ...

Screenshot_20230403-190146.png (2×1 px, 214 KB)

... should be on the last slide:

Screenshot_20230403-190201.png (2×1 px, 129 KB)

Please move it to the next column afterward; the rest looks good!

And thanks @cmadeo for helping out!

@scblr
Only a subsection of the people see the Machine suggestions onboarding slide - Only users in the experiment, who are in groups that enable them to see suggestions. So, I have made the change such that the promise text appears on second, if that is the last slide the user will see. Else, on Machine Suggestions slide.

ABorbaWMF subscribed.

Looks good to me on 2.7.50436-beta-2023-04-05

Moving this on as language-specific issues are handled in other tickets.