[DOCS] Documentation for v8 (meta issue)

[stevejgordon]

The current v8 documentation is limited and should be significantly expanded to describe features and patterns around usage. This meta issue tracks the high-level topics and coordinates doc-specific issues to focus on iterative improvements and additions. It is not exhaustive, and items are not listed in priority order. If you identify poorly documented or missing topics, please raise a specific issue where it can be discussed and potentially added to this tracking issue if agreed for inclusion.

Goals:

• Provide a good developer experience (new users and those migrating from prior versions).
• Describe patterns rather than attempting to document every endpoint.
• Provide example code which is fully copy-pastable and includes using directives.
• Ensure code is imported from test code, which remains current if changes are introduced.

Non-goals:

• Provide examples for every endpoint, query and aggregation. (Improved code snippets in the Elasticsearch source should cover those).

Documentation topics

Beta Give feedback

1. [DOCS] Add initial migration guidance for existing 7.x NEST users #7538
   0 of 4
   8.x Area: Documentation +2
2. [DOCS] Testing patterns when using the ElasticsearchClient #7626
   8.x Area: Documentation Docs +3
3. [DOCS] Object initializer syntax vs fluent (descriptor) syntax #7625
   8.x Area: Documentation +2
4. [DOCS] Search query concepts #7627
   8.x Area: Documentation +2
5. [DOCS] BoolQuery operator (BoolDsl) concepts #7628
   8.x Area: Documentation Docs +3
6. [DOCS] Aggregation concepts #7629
   8.x Area: Documentation +2
7. [DOCS] Working with the transport directly (low-level usage) #7630
   8.x Area: Documentation Docs +3
8. [DOCS] Bulk indexing and updating using the Bulk Helper #7649
   8.x Area: Documentation +2
9. [DOCS] Authenticating with Elasticsearch #7651
   8.x Area: Documentation +2