apache / apache/trafficserver

Verify default records.yaml matches in-code defaults

Open
#12,837 2 comments 0 reactions 1 assignee Claimed by @bryancall View on GitHub
Bug Configuration Documentation TLS
Dominant language
C++
Stars
2k
Forks
874
Avg merge
6d 15h
Merged PRs (30d)
46

Description

## Summary

There appears to be a discrepancy between the default values specified in `records.yaml` and the actual default values defined in the code. These should be verified and synchronized.

## Example Discrepancy

| Configuration | records.yaml Value | In-Code Default |
|---------------|-------------------|-----------------|
| `proxy.config.ssl.client.verify.server.policy` | PERMISSIVE | ENFORCED |

## Suggested Action

1. Audit all configuration defaults in `records.yaml` against their corresponding in-code defaults
2. Determine which value is the intended default
3. Synchronize the values to ensure consistency
4. Consider adding a CI check to prevent future drift between these two sources of truth

## Impact

Configuration mismatches can lead to unexpected behavior when users rely on documented defaults versus actual runtime defaults.

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.