feat(docs): improve explanation on how edit/save/cancel work under the hood

> eg The examples showing how edit, cancel and save work, don’t really explain anything they just show it working.

and

> can’t find how to change the mode from ‘edit’ when I save or cancel.

make sure this is crystal clear!!