Why are we doing this?

The Android app currently allows users to edit or add title descriptions (eg. Wikidata descriptions) to articles. We would like to expand this functionality to the iOS app.

Proposed solution

The flow below follows Android's implemented flow closely.

Prototype

https://wikimedia.invisionapp.com/share/BVHXMGQNJPW

Mocks

Editing

Edit reversion notification

Flows

First time user

Existing user

Reverted edit

Design details

• First time users of the feature are shown two on boarding screens
• First time users of the feature are shown a confirmation overlay after publishing their first description edit
• On subsequent edits users will not be shown the on boarding screens
• On subsequent edits users will be shown a system alert to confirm that their edit was published, not the overlay
• Users are notified by push notification or system alert when their edit is reverted

Scenarios

First time user

1. User navigates to an article that does not have a title description
2. User taps on CTA to 'Add title description'
3. User is shown the Title description on boarding flow
4. User taps through on boarding and taps on the CTA to 'Start editing'
5. User is navigated to the 'Add a description view'
6. Once the user enters a string between 1 and 90 characters long the 'Publish description' button is activated
7. If the user enters a string over 90 characters long the 'Publish description' button is activated AND a warning is shown with the character count highlighted in a warning color
8. User taps on 'Publish description'
9. User is shown the 'Description published' overlay
10. User taps on 'Done'
11. User is returned to article and their published title description is visible.

Non-first time user eg. has used the feature once before

1. User navigates to an article that does not have a title description
2. User taps on CTA to 'Add title description'
3. User is navigated to the 'Add a description view'
4. Once the user enters a string between 1 and 90 characters long the 'Publish description' button is activated
5. If the user enters a string over 90 characters long the 'Publish description' button is activated AND a warning is shown with the character count highlighted in a warning color
6. User taps on 'Publish description'
7. User is returned to article and their published title description is visible. System alert is shown stating that their edit has been published.

Reverted edit

1. Users title description edit is reverted by another user

2a. If the user has the app open a system alert is shown
2b. If user does not have the app open a push notification is shown

3. User taps on CTA or notification
4. User is navigated to the 'Reverted edit' view