Skip to content

Conversation

@alexey-ivanov-es
Copy link
Contributor

Depending on whether a message is critical or warning a message should
indicate to check breaking changes documentation (critical level) or
deprecation changes documentation (warn level)

relates #79666
Attempt to re-apply: #80900

@alexey-ivanov-es alexey-ivanov-es added the :Core/Infra/Core Core issues without another label label Jan 23, 2025
@alexey-ivanov-es
Copy link
Contributor Author

@github-actions
Copy link
Contributor

github-actions bot commented Feb 3, 2025

It looks like this PR modifies one or more .asciidoc files. These files are being migrated to Markdown, and any changes merged now will be lost. See the migration guide for details.

@alexey-ivanov-es alexey-ivanov-es added v9.0.0 auto-backport Automatically create backport pull requests when merged labels Feb 7, 2025
@github-actions
Copy link
Contributor

github-actions bot commented Feb 7, 2025

Warning

It looks like this PR modifies one or more .asciidoc files. These files are being migrated to Markdown, and any changes merged now will be lost. See the migration guide for details.

@alexey-ivanov-es alexey-ivanov-es marked this pull request as ready for review March 5, 2025 15:22
@alexey-ivanov-es alexey-ivanov-es requested a review from a team as a code owner March 5, 2025 15:22
@elasticsearchmachine elasticsearchmachine added the Team:Core/Infra Meta label for core/infra team label Mar 5, 2025
@elasticsearchmachine
Copy link
Collaborator

Pinging @elastic/es-core-infra (Team:Core/Infra)

private static final String DEPRECATED_MESSAGE_TEMPLATE =
"[{}] setting was deprecated in Elasticsearch and will be removed in a future release. "
+ "See the %s changes documentation for the next major version.";
private static final String DEPRECATED_WARN_MESSAGE = String.format(Locale.ROOT, DEPRECATED_MESSAGE_TEMPLATE, "deprecation");
Copy link
Member

Choose a reason for hiding this comment

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

This should use Strings.format (either class)

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Done

private static final String DEPRECATED_MESSAGE_TEMPLATE =
"[{}] setting was deprecated in Elasticsearch and will be removed in a future release. "
+ "See the %s changes documentation for the next major version.";
private static final String DEPRECATED_WARN_MESSAGE = String.format(Locale.ROOT, DEPRECATED_MESSAGE_TEMPLATE, "deprecation");
Copy link
Member

@thecoop thecoop Mar 6, 2025

Choose a reason for hiding this comment

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

'deprecation changes' doesn't make much sense, how about just 'See the deprecation documentation...' instead? Or 'deprecated functionality documentation'?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Done: "deprecation changes documentation" -> "deprecation documentation", breaking changes message remains "breaking changes documentation"

Copy link
Member

Choose a reason for hiding this comment

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

There's still some references to the old wording (and String.format(Locale.ROOT) in this PR eg in ESTestCase

@alexey-ivanov-es alexey-ivanov-es merged commit 02f01af into elastic:main Mar 7, 2025
17 checks passed
@alexey-ivanov-es alexey-ivanov-es deleted the settings_breaking_changes_warning branch March 7, 2025 15:32
@elasticsearchmachine
Copy link
Collaborator

💚 Backport successful

Status Branch Result
9.0

alexey-ivanov-es added a commit to alexey-ivanov-es/elasticsearch that referenced this pull request Mar 7, 2025
Depending on whether a message is critical or warning a message should
indicate to check breaking changes documentation (critical level) or
deprecation changes documentation (warn level)

relates elastic#79666
elasticsearchmachine pushed a commit that referenced this pull request Mar 7, 2025
Depending on whether a message is critical or warning a message should
indicate to check breaking changes documentation (critical level) or
deprecation changes documentation (warn level)

relates #79666
georgewallace pushed a commit to georgewallace/elasticsearch that referenced this pull request Mar 11, 2025
Depending on whether a message is critical or warning a message should
indicate to check breaking changes documentation (critical level) or
deprecation changes documentation (warn level)

relates elastic#79666
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

auto-backport Automatically create backport pull requests when merged :Core/Infra/Core Core issues without another label >non-issue Team:Core/Infra Meta label for core/infra team v9.0.0 v9.1.0

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants