Skip to content

Remove config duplication in examples#427

Merged
luoyuxia merged 1 commit intoapache:mainfrom
charlesdong1991:deduplicate-api-reference
Mar 7, 2026
Merged

Remove config duplication in examples#427
luoyuxia merged 1 commit intoapache:mainfrom
charlesdong1991:deduplicate-api-reference

Conversation

@charlesdong1991
Copy link
Contributor

Purpose

Linked issue: close #423

Brief change log

Replace duplicated config option tables in configuration.md in examples/ with cross-references to the authoritative tables in api-reference.md

Tests

No

| `writer_retries` | `writer.retries` | Get/set number of retries on failure |
| `writer_batch_size` | `writer.batch-size` | Get/set write batch size in bytes |
| `writer_batch_timeout_ms` | `writer.batch-timeout-ms` | Get/set max time in ms to wait for a writer batch to fill up before sending |
| `writer_bucket_no_key_assigner` | `writer.bucket.no-key-assigner` | Get/set bucket assignment strategy (`"sticky"` or `"round_robin"`) |
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

this property seems to be mis-spelled, and also description is outdated as well because it now has both setter and getter

config.scanner_log_max_poll_records = 500; // Max records per poll
config.connect_timeout_ms = 120000; // TCP connect timeout (ms)
```
See the [`Configuration`](../api-reference.md#configuration) section in the API Reference for the full list of configuration fields, types, and defaults.
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Different from what was proposed in the GH Issue, i think it's better to replace the duplicates in configuration.md in examples/, and reference api-reference instead.

Because configuration lives in examples, so intuitively to me, its primary role is showing how to use config with code examples.

Copy link
Contributor

@fresh-borzoni fresh-borzoni left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@charlesdong1991 TY for the PR, LGTM

Copy link
Contributor

@luoyuxia luoyuxia left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@charlesdong1991 Thanks for the pr and thanks @fresh-borzoni for reviewing. Merging..

@luoyuxia luoyuxia merged commit 65a8ad4 into apache:main Mar 7, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[docs] Remove config duplication in api-reference

3 participants