This is an abstract base type used in Stencila Schema for suggested document changes.

It exists to represent proposed edits as first-class nodes that can carry status, feedback, provenance, and original or replacement content. This supports review and model-assisted editing workflows that need suggestions to persist within the document model.

Key properties include the suggestion suggestionType, status, and any associated feedback or authorship metadata.

Analogues

The following external types, elements, or nodes are similar to a Suggestion:

word processor tracked change: Close editing analogue for persisted proposed changes, though Stencila suggestions are explicit typed nodes rather than markup overlays in a word-processing format.

Properties

The Suggestion type has these properties:

Name	Description	Type	Inherited from
`suggestionType`	The type of suggestion including whether it is an insertion or a deletion.	`SuggestionType`	-
`suggestionStatus`	The status of the suggestion including whether it is the original, or is accepted, or rejected.	`SuggestionStatus`	-
`authors`	The authors of the suggestion	`Author`*	-
`provenance`	A summary of the provenance of the content within the suggestion.	`ProvenanceCount`*	-
`datePublished`	Date of the suggestion was created.	`DateTime`	-
`executionDuration`	Time taken to generate the suggestion.	`Duration`	-
`executionEnded`	The timestamp when the generation ended.	`Timestamp`	-
`feedback`	Feedback on the suggestion	`String`	-
`id`	The identifier for this item.	`String`	`Entity`