LuciferYang opened a new pull request, #9592:
URL: https://github.com/apache/paimon/pull/9592
### Purpose
`ConfigOptionsDocsCompletenessITCase` is failing on master, and therefore on
every pull request built against it:
```
Documentation is outdated, please regenerate it according to the
instructions in paimon-docs/README.md.
Problems:
Option data-evolution.write-cols-optimization.enabled in class
org.apache.paimon.CoreOptions is not documented.
```
The option was added in #9574 without regenerating the reference. This runs
the command `paimon-docs/README.md` gives:
```
mvn package -Pgenerate-docs -pl paimon-docs -nsu -DskipTests -am
```
That produces two changes. The first is the missing row in
`core_configuration.html`, which is the failure above. The second is in
`flink_connector_configuration.html`: the generator sorts
`compaction.bucket-distribution-strategy` between `commit.callbacks` and
`end-input.watermark`, while the committed file has it at the top of the table,
where it was added by hand in #8583. The completeness check does not compare
ordering, so that one has been sitting there unnoticed; regenerating picks it
up.
### Tests
`mvn -pl paimon-docs -am test -Dtest=ConfigOptionsDocsCompletenessITCase` on
JDK 8: 1 test, 0 failures. It fails without these two files.
Note for anyone reproducing it: the test has to be run with `-am`, or it
loads a stale `paimon-api` from the local repository and reports the reverse
problem, that the documented options do not exist.
--
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]
