docs: pipeline: outputs: file: document dynamic destinations

[eschabell]

Document record accessor support in the path and file parameters along with max_dynamic_files, on_missing_field, on_limit_reached, fallback_path, and fallback_file. Add a section covering the static prefix requirement, the mandatory fallback_file, destination safety validation, and the available actions.

Note, this covers code merged without corresponding docs PR

Summary by CodeRabbit

• Documentation
  • Added guidance for configuring dynamic file destinations.
  • Documented supported path and file accessors, safety restrictions, fallback requirements, and directory creation behavior.
  • Added details on handling unresolved destinations and destination limits.
  • Expanded configuration references and examples for dynamic destinations and fallbacks.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: c1bb9b6a-ebdc-4b62-99e9-2188d9aa4e0f

📥 Commits

Reviewing files that changed from the base of the PR and between 012228c and 37f3e2d.

📒 Files selected for processing (1)

• pipeline/outputs/file.md

---

📝 Walkthrough

Walkthrough

The File output documentation now covers dynamic file destinations, record accessor support, fallback options, safety restrictions, destination limits, unresolved-destination actions, directory creation, and YAML and classic configuration examples.

Changes

File output documentation

Layer / File(s)	Summary
Dynamic destination reference pipeline/outputs/file.md	The configuration reference and examples document dynamic paths, fallback settings, safety checks, mkdir behavior, unresolved-destination actions, and destination limits.

Estimated code review effort: 1 (Trivial) | ~5 minutes

Suggested labels: waiting-on-code-merge

Suggested reviewers: sagiroosto

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title clearly and concisely describes the documentation added for dynamic destinations in the file output plugin.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}