Drafts / Revision creation, Saving, and Conflict Resolution unclear / unexplained for Front End Authors

[dlindberg]

Description

This is a front end author corollary to #36, the drafts / revisions workflow needs more documentation.

Editing Entries in Craft 3.7 is good basic introduction—however, as site size and entry complexity grow there are things it doesn't cover and I can't find canonical documentation for to point authors to for how it is all supposed to work. (Clarity on how it is supposed to work also makes it easier to know when something is a bug report versus a feature request.)

The big thing that is missing is edit conflict resolution and when you might accidentally overwrite someone else's changes without noticing. The automatic persistence of unsaved edits across page loads is very helpful, but it does mean that, in effect, people can be editing an entry "at the same time" hours, days, or even months apart.

Key concepts I noticed that need to be better explained:

• How to use the blue bar to keep track of what will be updated on save.
• How to compare your version to the current version when the "recent changes" warning appears.
• When merging a draft with the current version what get's merged and what get's overwritten.
• How Matrix reordering happens when merging a draft.
• What happens on the creation of different matrix blocks on two different drafts?

Additional info

• Craft version: 4.2.7
• PHP version: 8.1
• Database driver & version: MySQL 5.5.5