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

Add missing "aggregations" word #28507

Closed
wants to merge 1 commit into from

Conversation

alexmorosmarco
Copy link
Contributor

@alexmorosmarco alexmorosmarco commented Feb 3, 2018

I think that the sentence "they can only be
accessed within the scope of the nested query, the
nested/reverse_nested, or nested-inner-hits" is missing the explanation about what are the nested and reverse_nested terms. And I guess it must be related to the aggregations that exist for nested objects/documents.

Could you apply this change in all ElasticSearch documentation versions?

In addition, could you please take the issue I created (#28363) about the last paragraph of this same page? I think it is missing a lot of explanations as it is just a short sentence for something that I think it is really important.

Thanks.

I think that the sentence "they can only be
accessed  within the scope of the `nested` query, the
`nested`/`reverse_nested` aggregations, or nested-inner-hits" is missing the explanation about what are the `nested` and `reverse_nested` terms. And I guess it must be related to the aggregations that exist for nested objects/documents.

Could you apply this change in all ElasticSearch documentation versions?

In addition, could you please take the issue I created (elastic#28363) about the last paragraph of this same page? I think it is missing a lot of explanations as it is just a short sentence for something that I think it is really important.

Thanks.
@elasticmachine
Copy link
Collaborator

Since this is a community submitted pull request, a Jenkins build has not been kicked off automatically. Can an Elastic organization member please verify the contents of this patch and then kick off a build manually?

1 similar comment
@elasticmachine
Copy link
Collaborator

Since this is a community submitted pull request, a Jenkins build has not been kicked off automatically. Can an Elastic organization member please verify the contents of this patch and then kick off a build manually?

Copy link
Member

@cbuescher cbuescher left a comment

Choose a reason for hiding this comment

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

@alexmorosmarco makes sense to me too, thanks for the correction. I left a tiny comment, but will merge this to the branches currently active branches once this is adressed.

@@ -189,7 +189,7 @@ The following parameters are accepted by `nested` fields:

Because nested documents are indexed as separate documents, they can only be
accessed within the scope of the `nested` query, the
`nested`/`reverse_nested`, or <<nested-inner-hits,nested inner hits>>.
`nested`/`reverse_nested` aggregations, or <<nested-inner-hits,nested inner hits>>.
Copy link
Member

Choose a reason for hiding this comment

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

nit: I'd prefer the singular aggregation here.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

I prefer it in plural to better state that those are 2 different aggregations.

@alexmorosmarco
Copy link
Contributor Author

Thanks for your quick response.

In addition to this PR, could you please push the issue I created (#28363)?
Thanks!

@cbuescher cbuescher self-assigned this Feb 9, 2018
@clintongormley clintongormley added :Search/Search Search-related issues that do not fall into other categories and removed :Nested Docs labels Feb 14, 2018
@cbuescher
Copy link
Member

@alexmorosmarco thanks for this PR, I pushed it to master, the current version 6 branches and the last 5.6 release.
We usually don't push updates to older versions unless its a really important fix, so I will close this PR. If you open other documentation PRs and the error you are correcting is also present in the current documentation, it would be great if you could open the PRs agains master or one of the active 6.x branches. This makes tracking and backporting a little easier.

@cbuescher cbuescher closed this Feb 15, 2018
jasontedor added a commit to jasontedor/elasticsearch that referenced this pull request Feb 15, 2018
* master:
  Add a note to the docs that _cat api `help` option cannot be used if an optional url param is used (elastic#28686)
  Lift error finding utility to exceptions helpers
  Change "tweet" type to "_doc" (elastic#28690)
  [Docs] Add missing word in nested.asciidoc (elastic#28507)
  Simplify the Translog constructor by always expecting an existing translog (elastic#28676)
  Upgrade t-digest to 3.2 (elastic#28295) (elastic#28305)
  Add comment explaining lazy declared versions
@alexmorosmarco
Copy link
Contributor Author

Thanks for merging.
Can you apply this change to the version 2.4 that was where I discovered it?
I also wanted it fixed in the most recent versions as you did but I would like to include it the 2.4 also.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
>docs General docs changes :Search/Search Search-related issues that do not fall into other categories v5.6.8 v6.0.3 v6.1.4 v6.3.0 v7.0.0-beta1
Projects
None yet
Development

Successfully merging this pull request may close these issues.

5 participants