-
Notifications
You must be signed in to change notification settings - Fork 25.6k
[DOCS] Updated wording for clarity for new users #120257
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
Conversation
Documentation preview: |
Pinging @elastic/es-docs (Team:Docs) |
I would suggest renaming this note to be specific about types/behaviors. I'd reword the note to something like this:
I think the link to the flattening example is the best illustration of this behavior. |
(also remember to target |
Co-authored-by: Liam Thompson <[email protected]>
I also like the example in the flattened doc. I incorporated your heading and suggestions, though adjusted the wording a bit. |
Co-authored-by: Liam Thompson <[email protected]>
Co-authored-by: Liam Thompson <[email protected]>
Co-authored-by: Liam Thompson <[email protected]>
If we had time to workshop this a bit more, we could have made the "unexpected behavior" more explicit because it remains a little handwavey, but this is definitely an improvement 👍 |
Co-authored-by: Kofi B <[email protected]>
Co-authored-by: Kofi B <[email protected]>
Co-authored-by: Kofi B <[email protected]>
This is a small change but I felt the previous wording was only clear to those who already understand this behavior. Someone who is unfamiliar would be scratching their head, and hopefully this is an improvement.