---
title: "Combine a multi-document configuration | Proofline Help"
description: "The validator requires one YAML document per repository configuration file."
url: https://proofline.sh/help/yaml-combine-yaml-documents/
---

[Help center](/help/)

# Combine a multi-document configuration

The validator requires one YAML document per repository configuration file.

## Combine the settings under one version

A pasted template may contain a second `---` followed by another version or settings block. Combine the intended keys under one version and remove the second document boundary.

```
version: 2
guidance: Check that invoice writes are idempotent.
reviews:
  base_branches: ["main"]
```

When both documents define a setting, choose its intended value explicitly. Two copies of the same mapping key in the combined document trigger a duplicate-key error.

## Related guides

-   [Review repository configuration](/help/repository-configuration/)
