Home

Suggestion Block

This is an abstract base type used in Stencila Schema for suggestions that operate on block content.

It extends Suggestion so proposed changes to block-level nodes can share common suggestion behavior while remaining distinct from inline suggestions.

Key properties are primarily inherited from Suggestion, with semantics centered on block-content replacements and originals.

Analogues

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

Properties

The SuggestionBlock type has these properties:

NameDescriptionTypeInherited from
contentThe suggested content. For insertions and replacements, this is the new content; for deletions, this is the content being deleted.Block*-
originalThe original content. For replacements, this is the content being replaced; for deletions, this should be absent.Block*-
suggestionTypeThe type of suggestion including whether it is an insertion or a deletion.SuggestionTypeSuggestion
suggestionStatusThe status of the suggestion including whether it is the original, or is accepted, or rejected.SuggestionStatusSuggestion
authorsThe authors of the suggestionAuthor*Suggestion
provenanceA summary of the provenance of the content within the suggestion.ProvenanceCount*Suggestion
datePublishedDate of the suggestion was created.DateTimeSuggestion
executionDurationTime taken to generate the suggestion.DurationSuggestion
executionEndedThe timestamp when the generation ended.TimestampSuggestion
feedbackFeedback on the suggestionStringSuggestion
idThe identifier for this item.StringEntity

Related

The SuggestionBlock type is related to these types:

Bindings

The SuggestionBlock type is represented in:


This documentation was generated from SuggestionBlock.yaml by docs_types.rs.

© 2026 Stencila