-
Notifications
You must be signed in to change notification settings - Fork 25.5k
Update synthetic source documentation #112363
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
Update synthetic source documentation #112363
Conversation
Documentation preview: |
Pinging @elastic/es-docs (Team:Docs) |
Pinging @elastic/es-storage-engine (Team:StorageEngine) |
This reverts commit 0895a76.
This does not fix all of #112351, does it? So it should not be closed. |
I will remove the following entries in another PR so that we can backport it easily
|
<<copy-to,`copy_to`>> or with <<doc-values,`doc_values`>> disabled. | ||
default configuration. | ||
|
||
Synthetic source always sorts `boolean` fields. For example: |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Another note for a follow up is to replace "always sorts" with "may sort" or "does not preserve order" in cases like this.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Maybe we can have a single page that captures all this.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I will just say "may change" because usually that statement is followed by an example where the order actually is different. So I think the sentence is relevant to understand the example.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
LGTM
* docs: update synthetic source docs * fix: also doc values false works * Revert "fix: also doc values false works" This reverts commit 0895a76. * fix: update synthetic source documentation * fix: all field types support it * fix: no need to explicitly mention it * fix: synthetic source sorting * fix: may instead of might (cherry picked from commit ebd363d)
* docs: update synthetic source docs * fix: also doc values false works * Revert "fix: also doc values false works" This reverts commit 0895a76. * fix: update synthetic source documentation * fix: all field types support it * fix: no need to explicitly mention it * fix: synthetic source sorting * fix: may instead of might (cherry picked from commit ebd363d)
💚 All backports created successfully
Questions ?Please refer to the Backport tool documentation |
* docs: update synthetic source docs * fix: also doc values false works * Revert "fix: also doc values false works" This reverts commit 0895a76. * fix: update synthetic source documentation * fix: all field types support it * fix: no need to explicitly mention it * fix: synthetic source sorting * fix: may instead of might
* docs: update synthetic source docs * fix: also doc values false works * Revert "fix: also doc values false works" This reverts commit 0895a76. * fix: update synthetic source documentation * fix: all field types support it * fix: no need to explicitly mention it * fix: synthetic source sorting * fix: may instead of might
After all synthetic source improvements we introduced, documentation
needs to be updated to reflect the fact that it works for all field types
no matter the values of parameters like
doc_values
,store
orignore_malformed
.Note that in this PR we only target removing incorrect information.
Better documentation about new functionality will be added as part
of another PR.
Resolves #112351