[DOC] Terms (sub-)aggregation missing some low level parameters and accuracy details

[lukas-vlcek]

What do you want to do?

• Request a change to existing documentation
• Add new documentation
• Report a technical problem with the documentation
• Other

Tell us about your request.

The latest (as of writing 2.9.x) documentation on Terms Aggregation does not include some low level parameters and explanation of accuracy of the results and effect ordering and use of sub-aggregations. For example there are missing shard_size, show_term_doc_count_error, shard_min_doc_count and collect_mode to name some of them.

This can lead to user confusion like this one (on Slack channel).

What other resources are available?

I am listing some of the tickets that might have been relevant to some degree:

• [DOC] Missing documentation on Aggregations #4293
• [DOC-META] Create new Query DSL topic pages  #2173
• Do not evaluate shard_size and shard_min_doc_count at segment slice level OpenSearch#9085

[hdhalter]

Hi @kolchfa-aws - can you please route this appropriately, as it has to do with aggregations? Thanks!

[kolchfa-aws]

@hdhalter This is part of the missing aggregation pages and should be taken care of by whoever is doing that back documentation.

[hdhalter]

Ok, thanks. I'll leave unassigned for now until we determine who is taking this over.