This task is about adding the instrumentation necessary for us to know when people are using the visual editor's and wikieditor's [i] special characters toolbar [ii].
=== Background
T249072 asks for the Reply Tool to add support for the special characters toolbar.
In order to help decide how highly adding this support should be prioritized, we would like to know how often this feature is currently being used in other editing interfaces, where it is included.
=== Testing instructions
On https://en.wikipedia.beta.wmflabs.org/, verify the "Actions" (left column) cause the "Event(s)" (right column) to be emitted.
|Action | Event(s)
|---|---
|In VE, **open** the Special characters toolbar by clicking the `Ω` icon in VE's toolbar| feature: `specialCharacter`, action: `window-open-from-tool`
|In VE, **close** the Special characters toolbar by pressing the `Escape` key | feature: `specialCharacter`, action: `dialog-abort`
|In VE, **close** the Special characters toolbar by clicking the `Ω` icon in VE's toolbar|feature: `specialCharacter`, action: `dialog-abort`
|In VE, **insert** a character from the Special characters toolbar by clicking the `Ω` icon to open the toolbar and selecting a symbol from the "Greek" character set|feature: `specialCharacter`, action: `insert-greekextended`
|In VE, **insert** a character from the Special characters toolbar by clicking the `Ω` icon to open the toolbar and selecting a symbol from the "Often used" character set|feature: `specialCharacter`, action: `insert-other`
=== Requirements
The instrumentation we implement as part of this task should enable us to know:
1. When someone opens or closes the special characters toolbar
2. When someone adds a character from the special characters toolbar to the document
-- 2A. Which "set" the "added character" belongs (read: every time a character is added, we should log which group/set it came from (e.g. `Latin`, `Latin extended`, `IPA`, etc.))
=== Open questions
- [x] What events are required?
- [x] What should these events be called?
- [x] In what schema should these events be logged?
=== Done
- [x] All "Open questions" are answered
- [x] The changes described in the "Requirements" section above are implemented.
- [ ] @Ryasmeen: verify the events described in the "Requirements" section above are "firing" as described
- [ ] @MNeisler: update any relevant instrumentation spec with the events added as part of this task.
- [ ] @MNeisler: document whether the events implemented as part of this task are landing in the database in the ways we expect
- [ ] @MNeisler: update documentation [iii] with events added as part of this task. //Note: This will be done after everything looks good on production. //
---
i. https://www.mediawiki.org/wiki/User:DLynch_(WMF)/VisualEditor/Configurations#Data_analysis_notes
ii. {F32364019}
iii. E.g. [VisualEditorFeatureUse data dictionary](https://www.mediawiki.org/wiki/VisualEditor/FeatureUse_data_dictionary)