Configuration

Abstract

List configuration locations, defaults, precedence, validation, and environment-specific options.

This page should answer where configuration lives, how precedence works, and which settings are required for a run to succeed.

Audience

These pages are complete references for commands, APIs, configuration, files, reports, and exit codes.

What This Page Should Contain

1. Configuration locations and formats.
2. Precedence between flags, env vars, and config files.
3. Defaults and required fields.
4. Environment-specific overrides and validation rules.

Practical Sections

1. Testbed configuration.
2. Reporter configuration.
3. Runtime and instrumentation configuration.
4. CI overrides and local overrides.

Content Outline

1. List the complete surface area.
2. Mark stable public API versus internal or alpha behavior.
3. Document inputs, outputs, defaults, errors, and versioning.
4. Point back to guides for examples.

Practical Defaults

1. Show a minimal working config first.
2. Separate required options from optional tuning.
3. State how to verify that config was applied.
4. Explain what breaks when a setting is wrong.

Evidence To Add

• Real commands, APIs, or artifacts from the Blackbox showcase system.
• Links to related concept, guide, reference, or troubleshooting pages.
• Clear limits and prerequisites where the page touches alpha behavior.