User:Prtksxna/VeDiff

This document looks at the new visual diffs at different levels. Everything here could be on phabricator, but I wasn't sure what should and should not. Some of the things here might already be ✅,, or tracked. Feel free to add necessary templates, like Template:Tracked to the relevant subheadings.
 * Very specific, like particular kinds of diffs that are hard to figure out.
 * General comments on how the diffs are shown with some specific examples.
 * High level, about the idea and scope of this feature.

Scope
Is it a diff of all the visual changes of the page, or a visual way to see the diff of all the changes that have occurred in the page?Is the scope of this feature to also surface hidden changes like those to the metadata of the page or adding a comment to the page?

The changes are currently being shown in two ways, the red and green diffs, or as a comment in the sidebar. There usually is a blue highlight in the diff that corresponds to a comment in the sidebar. How are we deciding which changes need to be shown in which way? The way I see it, it can be reasoned about in two ways: Picking an approach would depend on what a majority of users expect from it. We should be consistent about it either way.
 * Visual change should be shown in the red/green way. This would mean that formatting changes, and converting some text to a link would show up in the diff.
 * Text change should be shown in the red/green way. This would mean that formatting changes, and converting some text to link would not show up in the diff, and in the comment sidebar instead.

Adding a link as a meta change
Adding a link to some existing text could be shown in the 'comments' instead of in the diff.

Simple formatting changes
Simple formatting changes like bold or italicized could be shown in the 'comments' instead of in the diff.

✅ Link comments with the change in the diff
Sometimes it is hard to figure out what the comment is about. Like comments in Google Docs, it should be possible to select it and see what part of the document it is referring to.

Remove strike-through on hover
Will improve readability.



Showing comments
Currently a new comment shows up as an added space in the content. Should this be complemented with a 'comment'?



Removing a space
Removing a space is shown as a space with a red background and strike-through. This looks the same as removing a hyphen.