Wire most of nav v1 content into nav v2

[theletterf]

demo/findability currently surfaces a much smaller portion of the docs in nav v2 than nav v1 surfaces today. A diff of config/navigation.yml + the .artifacts/checkouts/current/**/toc.yml graph against config/navigation-v2.yml showed 2,733 pages reachable in v1 nav but not in v2 — most of them in Reference, Release notes, and the Deploy and manage children that v2 had stubbed out as landing pages.

This PR closes ~96% of that gap (2,733 → 103) without changing v2's curated titles, ordering, or section structure. The remaining 103 pages are mostly two intentionally-skipped sections (explore-analyze and the disabled Contribute) plus a handful of stragglers — see "What's still missing" at the bottom.

Demo: https://docs-v3-preview.elastic.dev/elastic/docs-builder/docs/3268

What

Bulk rewiring (commit 1)

• Re-enabled the commented Reference block at the live - section: Reference (uncomment + slot in). Recovers ~1,222 pages: elasticsearch://reference/elasticsearch, kibana://reference, cloud://reference, cloud-on-k8s://reference, ecs://reference, search-ui://reference, ecctl://reference, plus aggregations, query-languages, scripting-languages, enrich-processor, text-analysis.
• Ported the Release notes tree from config/navigation.yml:33-209 into v2's stub Release notes section (dropped path_prefix: lines — v2 doesn't use them). Recovers ~126 pages: cloud hosted/enterprise, cloud-on-k8s, all APM agents, all EDOT SDKs, beats, logstash, elastic-agent, fleet-server, ECS, ECCTL, plus elastic-security, elastic-observability, elastic-cloud-serverless.
• Added per-product reference tocs missing from the commented block, grouped by family for readability. Recovers ~777 pages:
  • Elasticsearch clients: java, js, dsl-js, .net, php, py, ruby, rs, eland, go-elasticsearch, curator
  • APM: apm-k8s-attacher, apm-aws-lambda, dotnet, go, java, nodejs, php, python, ruby, rum-js
  • OpenTelemetry: opentelemetry root + motlp + edot-cloud-forwarder (aws/azure/gcp), elastic-agent edot-collector, edot-android, edot-dotnet, edot-ios, edot-java, edot-node, edot-php, edot-python, edot-browser
  • ECS Logging: ecs-logging root + .net, go-logrus, go-zap, go-zerolog, java, nodejs, php, python, ruby
  • Plus beats, logstash, integration-docs, elasticsearch-hadoop, elastic-serverless-forwarder, elasticsearch-plugins, community-contributed.
• Wired children of 12 deploy-manage landings: security, users-roles, monitor, tools, remote-clusters, upgrade, cloud-organization, maintenance, api-keys, autoscaling, license, uninstall. Hand-listed under each existing - group: to preserve v2's curated titles. The cleanest alternative (creating per-subtree toc.yml files in docs-content and switching v2 to toc:) was rejected because it would override v2's hand-curated group titles. ~369 pages.
• Removed the dead Troubleshoot comment block (~120 lines deleted). Verified all 53 pages it referenced are already reachable via the live - toc: docs-content://troubleshoot (which surfaces 190 pages).
• Applied Liam's Search and query rewrite from Add search/query pages #3094 — replaces the placeholder - group: Search and query with the full narrative arc (get-started → approaches → ingest → querying with elasticsearch://reference/query-languages toc inline → cross-cluster/cross-project → integrate). Liam credited as co-author. ~58 pages.

Observability (commit 2)

• APM > View and analyze data: discover-traces.md (between Drill down into data and Filter and search data, mirroring v1).
• OpenTelemetry use cases: llms/index.md ("LLM observability") as a sibling of Kubernetes observability.
• Streams > Process documents: 7 missing string/security/network processors (concat, join, lowercase, uppercase, trim, redact, network-direction) appended after existing string-op processors, before manual-pipeline-configuration.
• Streams: streamlang.md as a sibling of Process documents.

10 pages recovered.

Production guidance (commit 3)

Per Shaina's note that the remaining D&M misses sit under the production-guidance subtree, converted the two flat entries into groups and listed their canonical children from v1's deploy-manage toc:

• Run Elasticsearch in production
  • Design for resilience (3 children: small clusters, larger clusters, ECH and ECE)
  • Scaling considerations
  • Performance optimizations (6 children: general recommendations, indexing speed, search speed, approximate kNN, disk usage, size shards)
• Run Kibana in production
  • 6 children: HA and load balancing, configure memory, manage background tasks, traffic scaling, alerting, reporting

18 pages recovered.

Distributed architecture, deploy orchestrators, ingest architectures (commit 4)

• Distributed architecture: converts three flat entries into groups with canonical children — clusters-nodes-shards (node-roles), shard-allocation-relocation-recovery (shard-allocation-awareness + index-level-shard-allocation with delaying-allocation-when-node-leaves), and discovery-cluster-formation (6 children: hosts-providers, quorums, voting, bootstrap-cluster, cluster-state, cluster-fault-detection).
• Deploy orchestrators: adds deploy-an-orchestrator.md as a peer page under Elastic Cloud Enterprise, and as the landing of the existing "Deploy an orchestrator" group under Elastic Cloud on Kubernetes (with install.md demoted to first child to match v1 hierarchy).
• Ingest architectures: converts the leaf entry into a group with the canonical 16 children grouped by architecture (Agent to Elasticsearch, Agent with Logstash, Agent with Kafka, Air-gapped, Logstash as input, Agent through a proxy). Sets ingesting-data-for-elastic-solutions.md as the "Ingest by solution" group landing. Surfaces tools.md alongside the existing API/upload entries.

30 pages recovered.

Contribute section (added, then disabled — commits 4 and 5)

Initially added an isolated - section: Contribute pulling docs-content://contribute-docs via toc:, mirroring the Extension points pattern (~35 pages). Whether to surface contribute-docs in the public site is still open, so the section is now commented out as a ready-to-uncomment block rather than shipped.

Validation

• YAML parses cleanly.
• All 175 navigation tests pass (dotnet test tests/Navigation.Tests).
• Diff: ~+1,100 / −180 lines across 5 commits in config/navigation-v2.yml.

What's still missing (~103 pages)

Sections skipped entirely (~50 pages — intentional)

These three explore-analyze subtrees were left out because they need design judgement on which children to surface and where in v2's curated tree:

pages	section landing + children
32	docs-content://explore-analyze/scripting (landing + 31 children — Painless tutorials, debugging, security, etc.)
12	docs-content://explore-analyze/transforms (landing + 11 children — checkpoints, examples, alerts, scaling, setup, etc.)
5	docs-content://explore-analyze/query-filter (landing + 4 children — filtering, esql-kibana, grok-debugger, playground)
49	subtotal

Sections disabled pending decision (~35 pages)

pages	section
35	- section: Contribute (commented out in this PR — toc fans into contribute-docs/index, api-docs/*, content-types/*, how-to/*, style-guide/*, plus asciidoc-guide, locally, on-the-web, syntax-quick-reference, tools, vale-linter, vscode-extension)

Single-page misses (18 pages)

Truly scattered — same mechanical pattern as the deploy-manage batch can be applied later if someone wants to mop them up:

cloud-account/ (8)

• docs-content://cloud-account/index.md
• docs-content://cloud-account/add-a-login-method.md
• docs-content://cloud-account/change-your-password.md
• docs-content://cloud-account/dark-mode.md
• docs-content://cloud-account/high-contrast.md
• docs-content://cloud-account/join-or-leave-an-organization.md
• docs-content://cloud-account/multifactor-authentication.md
• docs-content://cloud-account/update-your-email-address.md

get-started/ (4)

• docs-content://get-started/introduction.md
• docs-content://get-started/deployment-options.md
• docs-content://get-started/the-stack.md
• docs-content://get-started/howto-use-the-docs.md

Other one-offs (3)

• docs-content://manage-data/index.md
• docs-content://deploy-manage/manage-spaces-fleet.md
• docs-content://solutions/search/vector.md

Phantom-only (3, reachable in v1 only via phantoms: registration, not in either nav)

• docs-content://release-notes/index.md
• cloud://release-notes/index.md
• elasticsearch://reference/index.md

🤖 Generated with Claude Code

[shainaraskas]

I have to step out for a while but at least the security section is broken so it needs to be edited before it is merged in.

fixed missing titles and unexpanded variables