T323145 produced a demo [i] for using the visual editor's existing "transaction" system for visually highlighting:
- What – if any – new content the software "thinks" was added during an edit and
- Where within an existing article the software "thinks" the new content it detects was added
This demo will help the Editing Team decide what – if any – changes we think ought to be made to how and when the visual editor draws a person's attention to the content they've just added ultimately, whether we think there is a need for us to consider an alternative technical approach to doing what "1." and "2." describe above (e.g. by using the visual diff "engine" instead, as T324736 describes).
Decisions to be made
- 1. What – if any – changes does the Editing Team think need to be made to how and when the visual editor draws a person's attention to the content they've just added
- The Editing Team will need to, at a minimum, prevent the edit check from thinking that the following "new content additions" warrant references:
- Blank lines
- Templates
- Images
- References themselves
- The Editing Team will need to, at a minimum, prevent the edit check from thinking that the following "new content additions" warrant references:
The work to augment the historic to reflect the above will happen in T324730
- 2. Will the Editing Team iterate on the approach T323145 produced to implement the changes they will have converged on in "1."? Will they instead pursue another approach (e.g. T324736)?
- The Editing Team will continue to move forward with the approach T323145 produced.
Requirements
The software should only draw peoples' attention to content that warrants their focus so that they come to trust in – and be responsive to – the prompts the software is surfacing to them.
Where "warrants their focus" in this context means:
- Content they explicitly added during the edit session they're currently in
- Content the majority of Senior Contributors would agree would benefit from being referenced
Where "warrants their focus" in this context does NOT mean:
- Content they did not add
- Changes that Senior Contributors would agree would be confusing/not make sense to reference (blank lines, spaces, formatting changes, moving existing content around via copy and paste, etc.)
Review
| CASE | DESCRIPTION | EXPECTED | ACTUAL | NOTES | RESULTING ACTION(S) |
|---|---|---|---|---|---|
| 1. | New blank line(s) | No highlight | ❗️Highlight | New blank lines unexpectedly highlighted | Non-issue for now; revisit in T324730 |
| 2. | Formatting existing content | No highlight | ✅ No highlight | --- | |
| 3. | Moving existing content (cut + paste) | No highlight | ❗️Highlight | Pasted content unexpectedly highlighted | Known limitation of transaction approach |
| 4. | Moving existing content (copy + paste) | No highlight | ❗️Highlight | Pasted content unexpectedly highlighted | Known limitation of transaction approach |
| 5. | Adding an image | No highlight | ❗️Highlight | Image unexpectedly highlighted | Non-issue for now; revisit in T324730 |
| 6. | Adding a template | No highlight | ❗️Highlight | Template unexpectedly highlighted | Non-issue for now; revisit in T324730 |
| 7. | Adding new sentence(s) (beg. existing paragraph) | Highlight | ✅ Highlight | --- | |
| 8. | Adding new sentence(s) (middle existing paragraph) | Highlight | ✅ Highlight | Highlight "leaked" onto a character in the sentence that follows the once I added/inserted. | --- |
| 9. | Adding new sentence(s) (end existing paragraph) | Highlight | ✅ Highlight | --- | |
| 10. | Adding a new section | Highlight | ✅ Highlight | --- | |
| 11. | Adding a new paragraph in existing section | Highlight | ✅ Highlight | --- | |
| 12. | Adding a reference | No highlight | ❗️Highlight | Reference highlighted, along with the added sentence it was preceded by | Non-issue for now; revisit in T324730 |
| 13. | Splitting a paragraph with Enter | No highlight | ✅ No highlight | --- | --- |
| 14. | Joining two paragraphs with Backspace | No highlight | ✅ No highlight | --- | --- |
Done
- The Editing Team has documented the revisions they think need to be made to the demo
- Answers to all Decisions to be made are documented