search

BookStackApp / BookStack

A platform to create documentation/wiki content built with PHP & Laravel
https://www.bookstackapp.com/
MIT License
15.02k stars 1.88k forks source link

Diff arbitrary revisions of pages #5027

Open highsciguy opened 4 months ago

highsciguy commented 4 months ago

Describe the feature you'd like

It would be great if BookStack could allow viewing changes between arbitrary revisions of a given page. Contenders realize that by viewing check boxes alongside the different revisions on the Page Revisions equivalent overview allowing the selection of two revisions to compare. Since the html diff function is already there, it seems the change would amount to mostly that frontend modification. Each diff also has an url, but that may not make sense to implement for arbitrary page comparisons.

Describe the benefits this would bring to existing BookStack users

Everyone would be able to see commutative changes rather than the often atomic differences between two revisions. The function eases the review of pages significantly.

Can the goal of this request already be achieved via other means?

You could export the html of two page versions and use an independent html diff tool to do the same, but who would do that.

Have you searched for an existing open/closed issue?

How long have you been using BookStack?

Not using yet, just scoping

Additional context

No response

david-prv commented 4 months ago

A feature that is for sure missing! Would be helpful for managing the different versions of a page. Especially in combination with https://github.com/BookStackApp/BookStack/issues/941 and others, this could enrich the revision feature a lot. I assume, that most BookStack instances are used by companies and thus it will become necessary for many to somehow moderate revision policies (e.g. enforce changelog comment) and compare changes made by different individuals (e.g. for precise rollbacks).

Hallsie commented 3 months ago

Just a question/thought... but it does that now. If you select a revision to view it doesn't show it side-by-side but does show green vs. red text where there are differences against the newest revision.

highsciguy commented 3 months ago

Just a question/thought... but it does that now. If you select a revision to view it doesn't show it side-by-side but does show green vs. red text where there are differences against the newest revision.

I cannot follow that. If on the "Page Revisions" page for a given Page, I click the "Changes" link of a revision in the list, I see the differences against the previous revision with inline change marks.

I am not looking for a side-by-side diff, but for the same type of diff, however for arbitrary revisions. In particular for the newest revision against the selected one.