Apply suggestions from code review

Co-authored-by: Andrew Herron <andrew.herron@tiny.cloud>

Author: MitchC1999

modules/ROOT/partials/configuration/suggestededits_content.adoc

@@ -2,11 +2,13 @@
 == `suggestededits_content`
 The `suggestededits_content` option determines where the initial content of the document is loaded from. With this option, you can set the content to be loaded from either the editor or the model, allowing you to control the source of truth for the document.
 
-When set to `'html'`, the editor loads the initial content from the HTML in the textarea or the `content` property. In this case, if a model is provided, it will need to match the content in the editor for the plugin to work correctly
+In a `'html'`-first approach, the editor loads content normally and the {pluginname} plugin provides augmentation. The integrator is responsible for saving the model at the same time as the editor content and providing it on the next load using the `suggestededits_model` option. This allows {pluginname} to be integrated quickly into a CMS by adding the model as an additional hidden field alongside the editor content.
 
-When set to `'model'`, the editor loads the initial content from the `suggestededits_model` option. In this case, the content in the editor will be overwritten with the content from the model. This would allow you to only require the model for document tracking, though it is still recommended to save the content in the editor externally.
+If a model is not provided the plugin will generate a new one from the initial content of the editor.
 
-In either case, if a model is not provided, the plugin will generate a new model from the current content of the editor, whether it is empty or not.
+When `suggestededits_content` is set to `'model'`, the plugin bypasses the editor's content load procedures and instead uses the `suggestededits_model` option to generate initial content. This would allow an integrator to only require the model for document tracking, and treat the editor content as simply a rendering of it.
+
+If a model is not provided, the plugin will allow the editor to load content normally and generate a new model from there (the same way `html` works).
 
 *Type:* `+String+`
 

modules/ROOT/partials/configuration/suggestededits_model.adoc

@@ -1,9 +1,11 @@
 [[suggestededits_model]]
 == `suggestededits_model`
 
-The `{plugincode}_model` option sets the initial model of the document to begin tracking changes. It takes as input an object representing the document, containing all edits made to the document up to that point. This model should be saved externally alongside the document, and loaded into the editor each time the document is opened. This will ensure that both the document and the model are in sync, and that the plugin can track edits correctly.
+The {pluginname} model is a JSON object representing the full document along with all unreviewed edits. The model should be kept in sync with the editor content and loaded into the editor each time the document is opened. If the model and content are out of sync, the difference between them will be applied as a suggested edit by the current user.
 
-If the model is not provided in the editor configuration, the plugin will create a new model from the current content of the editor. This model can be retrieved from the editor at any time using the xref:#get_model[`getModel` API].
+The `{plugincode}_model` option sets the initial model for an editor load. How this model is used depends on the `{plugincode}_content` setting.
+
+The model can be stored using the xref:#get_model[`getModel` API]. If the model is not provided the {pluginname} plugin will create a new model from the initial content of the editor, assuming all prior changes have been accepted.
 
 *Type:* `+Object+`
 

modules/ROOT/partials/events/suggestededits-events.adoc

@@ -3,7 +3,7 @@ The following events are provided by the xref:{plugincode}.adoc[{pluginname} plu
 [cols="1,1,2",options="header"]
 |===
 |Name       |Data                                       |Description
-|suggestededitsBeginReview   |N/A                   |Fired when the Suggested Edits view opens.
-|suggestededitsReviewComplete   |N/A |Fired when a review in the Suggested Edits view is completed. 
-|suggestededitsReviewCancelled |N/A                                        |Fired when a review in the Suggested Edits view is cancelled.
+|suggestededitsBeginReview.         |N/A        |The Suggested Edits view has opened.
+|suggestededitsReviewComplete   |N/A        |A review in the Suggested Edits view has been completed. 
+|suggestededitsReviewCancelled   |N/A        |A review in the Suggested Edits view was cancelled.
 |===

modules/ROOT/partials/plugin-apis/suggestededits-apis.adoc

@@ -2,10 +2,10 @@
 |===
 |Name   |Arguments    |Description
 
-|getModel |N/A |Return an object representing the document model used to store data of the suggested edits. 
+|getModel |N/A |Returns a JSON object representing the document model and all suggested edits. 
 |setModel | `+Object+` | Set the current model of the document. 
 //|resetModel |N/A |Reset the document to its original state. 
-|hasChanges |N/A |Return a boolean value indicating whether the document contains edits to be reviewed.  
+|hasChanges |N/A |Return a boolean value indicating whether the document contains suggested edits.  
 |===
 
 .Examples

modules/ROOT/partials/toolbar-button-ids/suggestededits-toolbar-buttons.adoc

@@ -3,5 +3,5 @@
 |Toolbar button identifier |Description
 
 |`+suggestededits+`   |Open the Review edits view.
-|`+suggestededits-label+` |Opens the Review edits view.
+|`+suggestededits-label+` |Opens the Review edits view (this button uses text instead of an icon).
 |===