==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**
| {F17606245} | {F17606225} |{F17606226} | {F17606228} | {F17606229} |{F17606231} |{F17606235} | {F17606244} | {F17606230} | {F17606233}
| https://zpl.io/29D1x1B | https://zpl.io/boBNQeo | https://zpl.io/2EjpJoy | https://zpl.io/aNpMJ84 | https://zpl.io/V4JMpxJ | https://zpl.io/VK0vZ8q | https://zpl.io/bPd7J8m | https://zpl.io/a7yB9NW | https://zpl.io/aMmNJ0R | https://zpl.io/VOW7w81
**Edit reversion notification**
| {F17606249} | {F17606246} | {F17606227} | {F17606232}
| https://zpl.io/aNp8zGN | https://zpl.io/bWRJdWK | https://zpl.io/2Zg1nyq | https://zpl.io/be4pk5Y
=== Flows
**First time user**
{F18064540 width=1000}
**Existing user**
{F18064539 width=1000}
**Reverted edit**
{F18064538 width=1000}
==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