This is a type used in Stencila Schema for document sections, analogous to section containers in HTML, JATS, and other structured document models.

It exists to group block content under headings while carrying structured metadata, authorship, and provenance. Unlike a plain heading hierarchy inferred from text alone, explicit sections allow more reliable transformation and editing workflows.

Key properties include sectionType, title, and content, together with inherited metadata from Entity.

Analogues

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

HTML <section>: Closest HTML sectioning analogue, though Stencila sections can carry typed section roles, authorship, and provenance metadata.

JATS <sec>: Closest JATS analogue for structured document sections.

Pandoc Div: Closest Pandoc container analogue when divisions are used to represent sections; Stencila uses a dedicated section node with explicit semantics.

MDAST Heading: Markdown ASTs often imply sections through heading structure rather than an explicit section container, so this is only an approximate analogue.

Properties

The Section type has these properties:

Name	Description	Type	Inherited from
`sectionType`	The type of section.	`SectionType`	-
`content`	The content within the section.	`Block`*	-
`authors`	The authors of the section.	`Author`*	-
`provenance`	A summary of the provenance of the content within the section.	`ProvenanceCount`*	-
`id`	The identifier for this item.	`String`	`Entity`

The Section type is related to these types:

Parents: Entity

Children: none

Bindings

The Section type is represented in:

JSON-LD

JSON Schema

Python class Section

Rust struct Section

TypeScript class Section

Testing

During property-based (a.k.a generative) testing, the properties of the Section type are generated using the following strategies.

Property	Complexity	Description	Strategy
`sectionType`	Min+	No type.	`None`
	Low+	Generate an arbitrary section type.	`option::of(SectionType::arbitrary())`
`content`	Min+	An empty vector	`Vec::new()`
	Low+	Generate an arbitrary heading and an arbitrary paragraph.	`vec_heading_paragraph()`
	High+	Generate up to four arbitrary, non-recursive, block nodes.	`vec_blocks_non_recursive(4)`
	Max	Generate up to eight arbitrary, non-recursive, block nodes.	`vec_blocks_non_recursive(8)`

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

Analogues

Properties

Related

Bindings

Testing