spuru9 opened a new pull request, #28895:
URL: https://github.com/apache/flink/pull/28895
## What is the purpose of the change
Four config options never appeared in the documentation. `rest.url-prefix`
and `shuffle-service-factory.class` carry no `@Documentation.Section`, so the
generator emits them only into per-class tables that no page includes. Two
PyFlink logging options were missing from the PyFlink configuration page.
## Brief change log
- Annotate `rest.url-prefix` with `COMMON_HOST_PORT` (matching its sibling
`rest.path`) and `shuffle-service-factory.class` with `EXPERT_CLUSTER`;
regenerate the two affected section tables.
- Add `python.logging.default.level` and `python.logging.level.overrides`
(added in FLINK-38690) to `flink-python/docs/user_guide/configuration.rst`.
- Regenerate the Chinese message catalog via `make gettext` + `sphinx-intl
update`. New entries are intentionally left untranslated.
## Verifying this change
This change is already covered by existing tests:
`ConfigOptionsDocsCompletenessITCase`, run with `mvn package -pl flink-docs
-am`. Re-running the generator afterwards produces no further diff, and all
four options now render on the configuration reference or the PyFlink
configuration page.
## Does this pull request potentially affect one of the following parts:
- Dependencies (does it add or upgrade a dependency): no
- The public API, i.e., is any changed class annotated with
`@Public(Evolving)`: yes — `RestOptions` and `ShuffleServiceOptions` are
`@PublicEvolving`, but only a documentation annotation was added; no API change
- The serializers: no
- The runtime per-record code paths (performance sensitive): no
- Anything that affects deployment or recovery: JobManager (and its
components), Checkpointing, Kubernetes/Yarn, ZooKeeper: no
- The S3 file system connector: no
## Documentation
- Does this pull request introduce a new feature? no
- If yes, how is the feature documented? not applicable
---
##### Was generative AI tooling used to co-author this PR?
- [X] Yes (please specify the tool below)
Generated-by: Claude Code (claude-opus-5)
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: [email protected]
For queries about this service, please contact Infrastructure at:
[email protected]
