[docs] Prepare for docs-assembler

[colleenmcginnis]

Related to elastic/docs-content#792

Restructure content and create toc.yml files needed by docs-assembler.

Restructured content so all toc.yml can be 2 or fewer levels below the docs/ directory:

• I got rid of the docs/reference/data-analysis directory and put the subdirectories up a level (docs/reference/data-analysis/aggregations → docs/reference/aggregations and docs/reference/data-analysis/text-analysis → docs/reference/text-analysis).
• I got rid of the docs/reference/ingestion-tools directory and put the subdirectories up a level (docs/reference/ingestion-tools/enrich-processor → docs/reference/enrich-processor and docs/reference/ingestion-tools/search-connectors → docs/reference/search-connectors).

Because of how we need to distribute files throughout the new IA, I think we need to create 9 unique toc.yml files:

• docs/reference/aggregations/toc.yml
  • After moving all the content that lived at docs/reference/data-analysis/aggregations/* to docs/reference/aggregations/*, I added a toc.yml file that contains just the pages related to aggregations to be inserted into the Data analysis section of the overall IA.
• docs/reference/community-contributed/toc.yml
  • I moved docs/reference/community-contributed.md to docs/reference/community-contributed/index.md so we could also add a toc.yml file with one page to be inserted into the Elasticsearch and index management / Clients section of the overall IA.
• docs/reference/elasticsearch/toc.yml
  • I created a new toc.yml that contains just the pages that belong at the top level of the Elasticsearch and index management section in the overall IA.
• docs/reference/elasticsearch-plugins/toc.yml
  • I created a new toc.yml that contains just the pages that belong in the Elasticsearch plugins section in the overall IA.
• docs/reference/enrich-processor/toc.yml
  • After moving all the content that lived at docs/reference/ingestion-docs/enrich-processor/* to docs/reference/enrich-processor/*, I added a toc.yml file that contains just the pages related to enrich processors to be inserted into the Ingestion tools section of the overall IA.
• docs/reference/query-languages/toc.yml
  • I created a new toc.yml that contains just the pages that belong in the Query languages section in the overall IA.
• docs/reference/scripting-languages/toc.yml
  • I created a new toc.yml that contains just the pages that belong in the Scripting languages section in the overall IA.
• docs/reference/search-connectors/toc.yml
  • After moving all the content that lived at docs/reference/ingestion-docs/search-connectors/* to docs/reference/search-connectors/*, I added a toc.yml file that contains just the pages related to search connectors to be inserted into the Ingestion tools section of the overall IA.
• docs/reference/text-analysis/toc.yml
  • After moving all the content that lived at docs/reference/data-analysis/text-analysis/* to docs/reference/text-analysis/*, I added a toc.yml file that contains just the pages related to text analysis to be inserted into the Data analysis section of the overall IA.

cc @Mpdreamz

[Mpdreamz]

Suggested change

	- file: reference/index.md
	children:
	- toc: reference/elasticsearch
	- toc: reference/community-contributed
	- toc: reference/enrich-processor
	- toc: reference/search-connectors
	- toc: reference/elasticsearch-plugins
	- toc: reference/query-languages
	- toc: reference/scripting-languages
	- toc: reference/text-analysis
	- toc: reference/aggregations
	- toc: reference

with reference/toc.yml holding:

 children:
    - toc: elasticsearch
    - toc: community-contributed
    - toc: enrich-processor
    - toc: search-connectors
    - toc: elasticsearch-plugins
    - toc: query-languages
    - toc: scripting-languages
    - toc: text-analysis
    - toc: aggregations

Otherwise it will trip the new validations: elastic/docs-builder#767

[colleenmcginnis]

I thought toc.yml files couldn't contain toc:s (only docset.yml can use toc:) or does elastic/docs-builder#767 also change that, too?

[colleenmcginnis]

I just did this for now 1b4df48.

[Mpdreamz]

there is no restriction on files origin, just depth so toc.yml file can hold toc.yml files as long as max_toc_depth is adhered too.

[elasticsearchmachine]

Pinging @elastic/es-docs (Team:Docs)

[leemthompo]

docs/reference/query-languages/toc.yml
I created a new toc.yml that contains just the pages that belong in the Query languages section in the overall IA.

@craigtaverner is this going to impact anything on your side? FYI some paths have been updated for a few esql pages

[leemthompo]

Folder rationalization and link path updates LGTM

[leemthompo]

💚 All backports created successfully

Status	Branch	Result
✅	9.0

Note: Successful backport PRs will be merged automatically after passing CI.

Questions ?

Please refer to the Backport tool documentation