Background
Through our user research we've learned how critical communication is with reverts. To improve communication when reverts to other people's edits are made, our team can improve the diff view. One way of making this improvement is encouraging users to leave a detailed, but respectful summary of the edit they've made (including reverts). This is aligned with Wiki policy.
User stories
Our current summary experience can be improved to achieve the following user stories:
- When my edit has been reverted, I want a clear distinction between the edit summary and the diff itself, so that I can process information more efficiently.
- When editing Wikipedia, I want the interface to give me clear direction for crafting helpful summaries in line with Wiki policies, so that patrollers and other users understand why I made the change that I did to an article.
- When accessing the Watchlist, I want to review a diff and clearly understand why an edit was made, so that I have the proper context to agree or dispute the change.
The Task
- If someone selects other, provide some guidance from the edit summary policy and the reverting guidance
- Do not allow people to publish without an edit summary
- Create parity for watchlist view and revision history view, to clearly call out when the edit summary is blank
Designs (Figma ↗)
1. Edit summary flow
1) Scrolls to section | 2) Taps edit | 3) Makes edit | 4) Previews edit | 5) Summarizes edit | 6) Suggestions | 7) Finalizes summary | 8) Success message |
Annotations
4) Previews edit:
- Preview is now separated from the preview (per @Moshtagh.maveddat’s excellent suggestion).
- It also includes the legal disclaimer as a sticky (position: fixed) element at the bottom of the screen.
5) Summarizes edit:
- Keyboard is active when users arrive on this screen to reduce steps.
- PUBLISH button can be tapped at any time but is de-emphasized to encourage publishing with a summary.
- If the article is on the user’s Watchlist, the Watch this page checkbox is enabled
- Links
- This is a minor edit info button/icon link: https://en.wikipedia.org/wiki/Help:Minor_edit
- Watch this page info button/icon link: https://en.wikipedia.org/wiki/Help:Watchlist
- Learn more about edit summaries link: https://en.wikipedia.org/wiki/Help:Edit_summary
- Chips prefill the input field with plain text. Tapping a chip always clears the input field first.
6) Suggestions:
- This feature exists already and might help users prepopulate the field if tasks are done repeatedly. We will keep it to respect existing user flows.
- After publishing a custom edit summary, the contents of it (e.g., “Formatting") are stored.
- Once users start typing, the previously stored custom edit summary is presented as an autocomplete suggestion.
- Tapping the suggestion fills the input field and takes users to 7)
7) Finalizes summary: PUBLISH button turns into colorAccent once the input field is populated with text.
2. Optimize the Watchlist screen
Please add Empty edit summary copy/info from Revision history to the Watchlist for consistency:
Revision history | Watchlist |
3) Requirement before release:
- Signoff from Shay on what is recorded to properly instrument new additions
- Determine if data should be recorded in MobileAppEdit or EditAttemptStep
APK: https://github.com/wikimedia/apps-android-wikipedia/pull/3536