# A multi-document stream. `---` starts a document, `...` ends one explicitly. A loader that
# calls the single-document API returns only the first document and silently discards the rest;
# the stream API returns all of them, including the deliberately empty one, which resolves to
# null rather than being skipped.
---
kind: Stage
name: build
order: 1
---
kind: Stage
name: test
order: 2
...
---
# This document contains only a comment, so it loads as null. It is still a document.
---
kind: Stage
name: deploy
order: 3
---
- a bare sequence is also a valid document
- second item
...