Why multi-doc exists
Kubernetes and CI configs often store multiple resources in one YAML file separated by `---`.
Partial edits can easily break structure when copying snippets.
Practical tips
Parse into an array and validate each document separately.
When converting back to YAML, emit `---` documents to preserve the common format.