Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

chore: Improve wording of error message #17766

Merged
merged 21 commits into from
Aug 2, 2024
Merged

Conversation

WanYixian
Copy link
Contributor

@WanYixian WanYixian commented Jul 22, 2024

I hereby agree to the terms of the RisingWave Labs, Inc. Contributor License Agreement.

What's changed and what's your intention?

According to request, use bail! .context anyhow Err String.format to do a global search of error messages and improve the wording.

This is the guidance.

Feel free to check out and see if all changes make sense, thanks!

@WanYixian WanYixian marked this pull request as draft July 22, 2024 07:46
@WanYixian WanYixian changed the title Improve wording of error message chore: Improve wording of error message Jul 22, 2024
Copy link
Contributor

@ShanlanLi ShanlanLi left a comment

Choose a reason for hiding this comment

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

LGTM

@@ -7,7 +7,7 @@ create source s (
properties.bootstrap.server = 'message_queue:29092'
) ROW FORMAT JSON;

statement error properties `scan_startup_mode` only support earliest and latest or leave it empty
statement error properties `scan_startup_mode` only supports earliest and latest or leaving it empty
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
statement error properties `scan_startup_mode` only supports earliest and latest or leaving it empty
statement error property `scan_startup_mode` only accepts three options: earliest, latest, or left empty

@@ -403,8 +403,8 @@ impl<S: StateStore, const USE_WATERMARK_CACHE: bool> DynamicFilterExecutor<S, US
let (range, _latest_is_lower, is_insert) = self.get_range(&curr, prev);

if !is_insert && self.condition_always_relax {
bail!("The optimizer inferred that the right side's change always make the condition more relaxed.\
But the right changes make the conditions stricter.");
bail!("The optimizer incorrectly assumed that changes on the right side always relax the condition.\
Copy link
Contributor

Choose a reason for hiding this comment

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

It's a bit hard to understand this message.

@WanYixian WanYixian marked this pull request as ready for review July 25, 2024 09:53
@WanYixian WanYixian requested review from lmatz and xxchan July 25, 2024 09:59
@xxchan xxchan mentioned this pull request Jul 26, 2024
10 tasks
@xxchan xxchan requested review from wenym1, xxhZs and fuyufjh July 26, 2024 03:55
@BugenZhao BugenZhao requested review from BugenZhao, a team and stdrc July 26, 2024 06:16
Copy link
Member

@stdrc stdrc left a comment

Choose a reason for hiding this comment

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

Added some change suggestions, including the following several aspects:

  1. Names (of columns, keys, schemas, tables, etc.) should be in ` inline code.
  2. Proper noun should be in proper form, e.g. Flink, RisingWave, BigQuery.

Another suggestion: Maybe we should prefer passive voice like Column (is) not found, Xxx mode is not supported, Property `xxx` of Xxx is not supported , Xxx required by xxx is not found. In this way, we can emphasize the object that is problematic.

WanYixian and others added 5 commits July 26, 2024 17:52
…m/risingwave/connector/CassandraUtil.java

Co-authored-by: Richard Chien <[email protected]>
…m/risingwave/connector/CassandraUtil.java

Co-authored-by: Richard Chien <[email protected]>
…m/risingwave/connector/CassandraUtil.java

Co-authored-by: Richard Chien <[email protected]>
…m/risingwave/connector/CassandraUtil.java

Co-authored-by: Richard Chien <[email protected]>
…-mock-flink-common/src/main/java/com/risingwave/mock/flink/common/FlinkDynamicUtil.java

Co-authored-by: Richard Chien <[email protected]>
WanYixian and others added 3 commits July 26, 2024 17:53
…-mock-flink-common/src/main/java/com/risingwave/mock/flink/common/FlinkDynamicUtil.java

Co-authored-by: Richard Chien <[email protected]>
Copy link
Member

@fuyufjh fuyufjh left a comment

Choose a reason for hiding this comment

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

LGTM.

src/connector/src/sink/deltalake.rs Outdated Show resolved Hide resolved
src/connector/src/sink/iceberg/mod.rs Outdated Show resolved Hide resolved
src/connector/src/sink/mqtt.rs Outdated Show resolved Hide resolved
src/connector/src/sink/mqtt.rs Outdated Show resolved Hide resolved
src/connector/src/sink/mqtt.rs Outdated Show resolved Hide resolved
src/connector/src/sink/nats.rs Outdated Show resolved Hide resolved
src/connector/src/sink/nats.rs Outdated Show resolved Hide resolved
@stdrc
Copy link
Member

stdrc commented Jul 30, 2024

@BugenZhao any other suggestions?

@fuyufjh fuyufjh enabled auto-merge August 2, 2024 04:29
@fuyufjh fuyufjh added this pull request to the merge queue Aug 2, 2024
Merged via the queue into main with commit 911578c Aug 2, 2024
31 checks passed
@fuyufjh fuyufjh deleted the wyx/review-error-message branch August 2, 2024 09:07
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants