knowledge icon indicating copy to clipboard operation
knowledge copied to clipboard

[IMP] document_page: Allow to show diffs using markdown

Open etobella opened this issue 2 months ago • 5 comments

Shows differences by markdown:

image

etobella avatar Oct 27 '25 12:10 etobella

And what happens with HTML?

pedrobaeza avatar Oct 27 '25 15:10 pedrobaeza

The proble with diff made with HTML is that is usually less clear to final users. It includes a lot of changes, that are not clear for them. Markdown is clear for them. In any case, with the current change, the mardown difference is only accessible if you have defined it (we could even do a parameter for this in order to make it cleaner and keep HTML by default).

etobella avatar Oct 27 '25 15:10 etobella

Yeah, what I mean is that right now, there's no HTML diff, but plain text over HTML code diff, so what I'm talking about is to render the HTML and the marks of diff.

pedrobaeza avatar Oct 28 '25 07:10 pedrobaeza

I am not sure if that is factible... for example Github is not doing that with html files It shows the diff of lines.

etobella avatar Oct 28 '25 08:10 etobella

Well, but that's because it's mostly code, but here we have documentation in rich text format, so I think it's a different beast, and we should provide proper tools for it.

pedrobaeza avatar Oct 28 '25 10:10 pedrobaeza