Skip to content

Conversation

thecoop
Copy link
Member

@thecoop thecoop commented Sep 26, 2024

There needs to be some reference to locale database in the docs

@thecoop thecoop added >docs General docs changes :Core/Infra/Core Core issues without another label v8.16.0 v8.15.3 labels Sep 26, 2024
Copy link
Contributor

Documentation preview:

@elasticsearchmachine
Copy link
Collaborator

Pinging @elastic/es-docs (Team:Docs)

@elasticsearchmachine elasticsearchmachine added Team:Core/Infra Meta label for core/infra team Team:Docs Meta label for docs team labels Sep 26, 2024
@elasticsearchmachine
Copy link
Collaborator

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

@thecoop thecoop added v7.17.25 auto-backport Automatically create backport pull requests when merged labels Sep 26, 2024
@thecoop thecoop requested review from a team and rjernst September 26, 2024 16:39
@thecoop thecoop removed the auto-backport Automatically create backport pull requests when merged label Sep 27, 2024
Copy link
Contributor

@prdoyle prdoyle left a comment

Choose a reason for hiding this comment

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

Looks great!

with ingest, output, and re-indexing. It is recommended to always use numerical fields in custom date formats,
which are not affected by locale information.

There can also be differences in week-date calculations using the `Y`, `W`, and `w` field specifiers.
Copy link
Contributor

Choose a reason for hiding this comment

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

I love how explicit the list of field specifiers is.

Would it make sense to word this advice such that we could add these three stragglers to the bullet list above, to provide one-stop-shopping for users who want to ensure they avoid this problem? I could envision a user swiping the above list and pasting it into a Jira ticket, thereby missing these three.

Copy link
Member Author

Choose a reason for hiding this comment

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

Possibly, however the effects are quite different for each type, and I expect users to read the whole doc

A formatter for a full date as four digit weekyear, two digit week of
weekyear, and one digit day of week: `xxxx-'W'ww-e`.
weekyear, and one digit day of week: `YYYY-'W'ww-e`.
This uses the ISO week-date definition.
Copy link
Contributor

Choose a reason for hiding this comment

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

👍

@thecoop thecoop merged commit 53d9c3c into elastic:8.x Sep 30, 2024
15 checks passed
thecoop added a commit to thecoop/elasticsearch that referenced this pull request Sep 30, 2024
@thecoop thecoop deleted the locale-docs branch September 30, 2024 10:12
thecoop added a commit that referenced this pull request Oct 2, 2024
Forward-port changes from #113787, and update the docs with similar information to #113587
gmarouli pushed a commit to gmarouli/elasticsearch that referenced this pull request Oct 3, 2024
…stic#113870)

Forward-port changes from elastic#113787, and update the docs with similar information to elastic#113587
matthewabbott pushed a commit to matthewabbott/elasticsearch that referenced this pull request Oct 4, 2024
…stic#113870)

Forward-port changes from elastic#113787, and update the docs with similar information to elastic#113587
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

:Core/Infra/Core Core issues without another label >docs General docs changes Team:Core/Infra Meta label for core/infra team Team:Docs Meta label for docs team v7.17.25 v8.15.3 v8.16.0

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants