This task covers a couple of related ideas that surfaced in a collaborative ticket-writing session.
== Feature Summary ==
On the current experience, instead of just displaying the paragraph split, the diff looks like an entire chunk of text was deleted and then added back. Also, if there’s a word change inside the paragraph that has been split, the change isn’t highlighted/noted anywhere. This error could lead to cases of vandalism that might be overlooked.
There is a difference in how the diff is represented when you press enter once vs. when you press enter twice.
When you press enter once, the diff takes it as adding a space, and not a new line. There isn’t a paragraph break. See this video on how it looks when you press enter once:
[[ https://drive.google.com/file/d/123-LbGAlEgyvzPHEE8sKEAwVl6quI73l/view?usp=sharing | Link ]]
When you press enter twice, the diff takes it as a new line, and the paragraph is split. See this video:
[[ https://drive.google.com/file/d/1jtkfR2mbWzvvASWJSiDfaW9bDqNDnWwy/view?usp=sharing | Link ]]
== Use cases ==
- As a viewer of the Two-column Wikitext Diff diff on Desktop: I am able to recognize when a paragraph has been split.
- As a viewer of the Two-column Wikitext Diff diff on Desktop: I am able to see a visual marker to show when a word changed within a paragraph that was split up as its own paragraph.
== Benefits ==
All users of the diff view will better understand when a paragraph has been split, rather than text being deleted and re-added.
== Details for QA ==
- Add test coverage for existing functionality, if missing
- Acceptance Criteria: This change must ensure "functionality parity" in all other diff stress tests
- Make sure markup/css changes to wikidiff do not break PHP engine output
== Designs and details ==
**Space (pressing enter once)**
The action of pressing enter once will be represented with a sea of blue highlight, that represents the space that forms, in this case, between “Water” and “North”.
| Current experience | Proposed design |
| ----- | ----- | ----- | -----
| {F36483058} | {F36483060}
**Paragraph split (pressing enter twice)**
The paragraph split would be represented with a highlight that extends throughout the whole box representing the addition of a new line between the two paragraphs. On the left the complete and original paragraph would show.
| Current experience | Proposed design |
| ----- | ----- | ----- | -----
| {F36483066} | {F36291323}
== Impact ==
- Make a more accessible better diffs.
== Contact Person / Team ==
- Community Tech
== Related Conversations ==
Slack channels
- better-diffs
- diffs-working-group
== Timing ==
- TBD