###Open questions
- [ ] How will we be able to interact with the data our instrumentation/event logging is gathering?
- [ ] Will we need to oversample Edit events?
###Overview
This task [and its subtasks] is about the work involved with instrumenting both the existing and revised [1] adding/modifying links and citations workflows on mobile, in VE.
###Background
We know what proportion of edits using the visual editor involve using common editing features. [2] We do not //yet// know how many contributors take which actions //within// these workflows. We are pursuing instrumentation to help us answer questions related to this second part. Questions like...
- What % of contributors who start to add/modify a link and citation are successful in doing so? How do these proportions compare across the existing and revised workflows?
-- This kind of information could be helpful in identifying opportunities to make adjustments that will help these contributors find their way (read: be successful in) adding/modifying links/citations.
- Do "Edit cards" encourage more people to engage more deeply with adding/modifying links and citations?
-- Asked another way: "What percentage of contributors who are shown the edit card (revised) or context item (existing) end up engaging with it?"
- What % of edit sessions, in which contributors successfully add/modify a link, result in them attempting to save their edits?" How do the revised and end existing flows compare in this way?
- Do "Edit cards" cause more people to add/modify links and citations more efficiently?
This work sits within our larger effort to improve the mobile edit completion rate. Work that depends on us being able to know what contributors actually do after starting an editing session.
######*Existing* "adding/modifying links" event logging needs:
(@Neil_P._Quinn_WMF to finish defining)
- .
- .
- .
###*Revised* "adding/modifying links" event logging needs:
(@Neil_P._Quinn_WMF to finish defining)
- When does the context item get shown?
- When do contributors tap the "馃敆" icon in the toolbar?
- When do contributors tap the "unlink" button in the context item?
- When do contributors tap the "edit link target" button in the context item?
- When do contributors tap the "edit label text" button in the context item?
- When do contributors tap the "edit link target" button in the context item?
- When do contributors tap into the link search dialog in the link inspector view?
- When do contributors tap/select a Wikipedia article link from within the inspector view search results?
- When do contributors tap the "Done" button in the link inspector view?
###Resources
- [Schema:VisualEditorFeatureUse](https://meta.wikimedia.org/wiki/Schema:VisualEditorFeatureUse)
- [Wireframes: linking w/ contextual inputs](https://wikimedia.invisionapp.com/freehand/document/s1duRw6io)
- [Mobile context items hypotheses](https://phabricator.wikimedia.org/T221247)
- [Desktop VE feature use](https://docs.google.com/spreadsheets/d/1FZsIZk7ty9xB92TQRBnxdmXpt3vEcWCjxZy0YPt85Nc/edit#gid=0)
---
###References
1. **Revised workflows**: https://phabricator.wikimedia.org/T221247
2. **Feature use data**: https://www.mediawiki.org/wiki/VisualEditor_on_mobile_report