Behaviour

• Edition of sections requires an explicit action (dropdown > edit). The whole Section is toggled in Edit mode. The title and the description part of the section are separated. Both can be changed and there is an explicit “Save” action. There is a check to ensure that no data is lost on page leave.

• The text can only be edited with the WYSIWYG editor (underlying storage is HTML). If the Description is stored in Markdown or Text, it's automatically converted to HTML at save time.

At save time:

• Multiple sections can be edited in parallel but each section must be saved explicitly
• in case of error
  • backend throw a 40X or 50X => the error message is displayed and there is a "Retry" and "Cancel" button (to let user modify the structure of the tracker for instance)
  • conflict (artifact updated in between) => the error message indicate that user is about to overwrite and have the possibility to "Force update" or "Retrieve the last version"

Permissions

• In a given document, some Sections (artifacts) can be edited and some read-only
• A given section is editable if user can Update both Title and Description fields.