Skip to content

Commit 497d3ab

Browse files
Fix broken cross-links in kibana and elasticsearch hub pages
Surfaced by the new HubLinkValidator in docs-builder, which now routes {hero}, {link-card}, and {whats-new} URLs through CrossLinkResolver. kibana/v9.md: - kibana://reference/kibana/... -> kibana://reference/... (kibana docset published its reference under reference/, not reference/kibana/) - cloud://reference/cloud/cloud-hosted/... -> cloud://reference/cloud-hosted/... elasticsearch/v9.md: - Several elasticsearch://reference/X.md paths point to directory index pages and resolve as reference/X/index.md in the link index. - Client docs live in their own repos and need scheme-specific cross-links: elasticsearch://reference/elasticsearch/clients/go/... -> go-elasticsearch://... elasticsearch://reference/elasticsearch/clients/java/... -> elasticsearch-java://... elasticsearch://reference/elasticsearch/clients/php.md -> elasticsearch-php://reference/index.md elasticsearch://reference/elasticsearch/clients/python.md -> elasticsearch-py://reference/index.md elasticsearch://reference/elasticsearch/clients/python/elasticsearch-dsl.md -> elasticsearch-py://reference/elasticsearch-dsl.md elasticsearch://reference/elasticsearch/clients/ruby/api.md -> elasticsearch-ruby://reference/api.md elasticsearch://reference/elasticsearch/clients/rust.md -> elasticsearch-rs://reference/index.md elasticsearch://reference/elasticsearch/clients/community.md -> elasticsearch://reference/community-contributed/index.md Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
1 parent 782b9f0 commit 497d3ab

2 files changed

Lines changed: 44 additions & 44 deletions

File tree

products/elasticsearch/v9.md

Lines changed: 23 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -180,7 +180,7 @@ links:
180180

181181
:::{link-card}
182182
title: Other query languages
183-
link: elasticsearch://reference/query-languages.md
183+
link: elasticsearch://reference/query-languages/index.md
184184
description: Use EQL for event sequences, SQL for familiar syntax, or Painless for custom scoring and scripted queries.
185185
links:
186186
- label: EQL (Event Query Language)
@@ -211,31 +211,31 @@ aside:
211211
label: Aggregation families
212212
links:
213213
- label: Metric
214-
url: elasticsearch://reference/aggregations.md
214+
url: elasticsearch://reference/aggregations/index.md
215215
- label: Bucket
216-
url: elasticsearch://reference/aggregations.md
216+
url: elasticsearch://reference/aggregations/index.md
217217
- label: Pipeline
218-
url: elasticsearch://reference/aggregations.md
218+
url: elasticsearch://reference/aggregations/index.md
219219
- label: Matrix
220-
url: elasticsearch://reference/aggregations.md
220+
url: elasticsearch://reference/aggregations/index.md
221221
:::
222222

223223
:::{link-card}
224224
title: Metric aggregations
225-
link: elasticsearch://reference/aggregations.md
225+
link: elasticsearch://reference/aggregations/index.md
226226
description: Compute single numeric values from field data — min, max, avg, sum, percentiles, stats, and more.
227227
links:
228228
- label: Top hits
229229
url: elasticsearch://reference/aggregations/search-aggregations-metrics-top-hits-aggregation.md
230230
- label: Top metrics
231231
url: elasticsearch://reference/aggregations/search-aggregations-metrics-top-metrics.md
232232
- label: Cardinality, percentiles, stats
233-
url: elasticsearch://reference/aggregations.md
233+
url: elasticsearch://reference/aggregations/index.md
234234
:::
235235

236236
:::{link-card}
237237
title: Bucket and pipeline aggregations
238-
link: elasticsearch://reference/aggregations.md
238+
link: elasticsearch://reference/aggregations/index.md
239239
description: Group documents into buckets, then chain pipeline aggregations to compute on those buckets.
240240
links:
241241
- label: Filters aggregation
@@ -255,7 +255,7 @@ links:
255255

256256
:::{link-card}
257257
title: Mapping
258-
link: elasticsearch://reference/elasticsearch/mapping-reference.md
258+
link: elasticsearch://reference/elasticsearch/mapping-reference/index.md
259259
description: Define how documents and their fields are stored, indexed, and analyzed.
260260
links:
261261
- label: Field data types
@@ -304,15 +304,15 @@ links:
304304

305305
:::{link-card}
306306
title: Configuration reference
307-
link: elasticsearch://reference/elasticsearch/configuration-reference.md
307+
link: elasticsearch://reference/elasticsearch/configuration-reference/index.md
308308
description: All Elasticsearch node settings — network, thread pools, index defaults, security, and more.
309309
links:
310310
- label: Node settings
311311
url: elasticsearch://reference/elasticsearch/configuration-reference/node-settings.md
312312
- label: Security settings
313313
url: elasticsearch://reference/elasticsearch/configuration-reference/security-settings.md
314314
- label: All settings reference
315-
url: elasticsearch://reference/elasticsearch/configuration-reference.md
315+
url: elasticsearch://reference/elasticsearch/configuration-reference/index.md
316316
:::
317317
::::
318318

@@ -489,30 +489,30 @@ link: /reference/elasticsearch-clients.md
489489
description: Official Elasticsearch clients for your preferred programming language.
490490
links:
491491
- label: Python
492-
url: elasticsearch://reference/elasticsearch/clients/python.md
492+
url: elasticsearch-py://reference/index.md
493493
- label: Java
494-
url: elasticsearch://reference/elasticsearch/clients/java/getting-started.md
494+
url: elasticsearch-java://reference/getting-started.md
495495
- label: Go
496-
url: elasticsearch://reference/elasticsearch/clients/go/using-the-api/dense-vectors.md
496+
url: go-elasticsearch://reference/using-the-api/dense-vectors.md
497497
- label: Rust
498-
url: elasticsearch://reference/elasticsearch/clients/rust.md
498+
url: elasticsearch-rs://reference/index.md
499499
- label: PHP
500-
url: elasticsearch://reference/elasticsearch/clients/php.md
500+
url: elasticsearch-php://reference/index.md
501501
- label: Ruby
502-
url: elasticsearch://reference/elasticsearch/clients/ruby/api.md
502+
url: elasticsearch-ruby://reference/api.md
503503
- label: Community clients
504-
url: elasticsearch://reference/elasticsearch/clients/community.md
504+
url: elasticsearch://reference/community-contributed/index.md
505505
:::
506506

507507
:::{link-card}
508508
title: Python DSL and helpers
509-
link: elasticsearch://reference/elasticsearch/clients/python/elasticsearch-dsl.md
509+
link: elasticsearch-py://reference/elasticsearch-dsl.md
510510
description: High-level Python libraries that simplify building queries, mappings, and bulk operations.
511511
links:
512512
- label: Elasticsearch DSL (Python)
513-
url: elasticsearch://reference/elasticsearch/clients/python/elasticsearch-dsl.md
513+
url: elasticsearch-py://reference/elasticsearch-dsl.md
514514
- label: Java bulk indexing
515-
url: elasticsearch://reference/elasticsearch/clients/java/usage/indexing-bulk.md
515+
url: elasticsearch-java://reference/usage/indexing-bulk.md
516516
- label: Troubleshoot clients
517517
url: /troubleshoot/elasticsearch/clients.md
518518
:::
@@ -525,7 +525,7 @@ links:
525525
- label: Fleet and Elastic Agent
526526
url: /reference/fleet.md
527527
- label: Content connectors
528-
url: elasticsearch://reference/search-connectors.md
528+
url: elasticsearch://reference/search-connectors/index.md
529529
- label: All ingest options
530530
url: /manage-data/ingest.md
531531
:::
@@ -537,7 +537,7 @@ links:
537537

538538
:::{link-card}
539539
title: REST APIs
540-
link: elasticsearch://reference/elasticsearch/rest-apis.md
540+
link: elasticsearch://reference/elasticsearch/rest-apis/index.md
541541
description: Conventions, common options, compatibility guarantees, and the full interactive API specification.
542542
links:
543543
- label: API conventions

products/kibana/v9.md

Lines changed: 21 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -210,19 +210,19 @@ links:
210210

211211
:::{link-card}
212212
title: Alerting connectors
213-
link: kibana://reference/kibana/connectors-kibana/alerting-cases-connectors.md
213+
link: kibana://reference/connectors-kibana/alerting-cases-connectors.md
214214
description: Send alerts and case updates to external incident-management tools.
215215
links:
216216
- label: Jira
217-
url: kibana://reference/kibana/connectors-kibana/jira-action-type.md
217+
url: kibana://reference/connectors-kibana/jira-action-type.md
218218
- label: ServiceNow ITSM
219-
url: kibana://reference/kibana/connectors-kibana/servicenow-action-type.md
219+
url: kibana://reference/connectors-kibana/servicenow-action-type.md
220220
- label: PagerDuty
221-
url: kibana://reference/kibana/connectors-kibana/pagerduty-action-type.md
221+
url: kibana://reference/connectors-kibana/pagerduty-action-type.md
222222
- label: Slack
223-
url: kibana://reference/kibana/connectors-kibana/slack-action-type.md
223+
url: kibana://reference/connectors-kibana/slack-action-type.md
224224
- label: Webhook
225-
url: kibana://reference/kibana/connectors-kibana/webhook-action-type.md
225+
url: kibana://reference/connectors-kibana/webhook-action-type.md
226226
:::
227227
::::
228228

@@ -249,15 +249,15 @@ links:
249249

250250
:::{link-card}
251251
title: Gen-AI connectors
252-
link: kibana://reference/kibana/connectors-kibana/gen-ai-connectors.md
252+
link: kibana://reference/connectors-kibana/gen-ai-connectors.md
253253
description: Wire Kibana up to LLM providers for use in Agent Builder, alerting summaries, and AI Assistant features.
254254
links:
255255
- label: OpenAI
256-
url: kibana://reference/kibana/connectors-kibana/openai-action-type.md
256+
url: kibana://reference/connectors-kibana/openai-action-type.md
257257
- label: Amazon Bedrock
258-
url: kibana://reference/kibana/connectors-kibana/bedrock-action-type.md
258+
url: kibana://reference/connectors-kibana/bedrock-action-type.md
259259
- label: Google Gemini
260-
url: kibana://reference/kibana/connectors-kibana/gemini-action-type.md
260+
url: kibana://reference/connectors-kibana/gemini-action-type.md
261261
:::
262262

263263
:::{link-card}
@@ -436,11 +436,11 @@ links:
436436

437437
:::{link-card}
438438
title: Console
439-
link: cloud://reference/cloud/cloud-hosted/ec-api-console.md
439+
link: cloud://reference/cloud-hosted/ec-api-console.md
440440
description: Run Elasticsearch and Kibana API requests interactively, with auto-complete and history.
441441
links:
442442
- label: Console overview
443-
url: cloud://reference/cloud/cloud-hosted/ec-api-console.md
443+
url: cloud://reference/cloud-hosted/ec-api-console.md
444444
:::
445445

446446
:::{link-card}
@@ -466,9 +466,9 @@ links:
466466
- label: Kibana serverless API
467467
url: https://www.elastic.co/docs/api/doc/serverless-kibana
468468
- label: Plugins
469-
url: kibana://reference/kibana/kibana-plugins.md
469+
url: kibana://reference/kibana-plugins.md
470470
- label: kibana-setup command
471-
url: kibana://reference/kibana/commands/kibana-setup.md
471+
url: kibana://reference/commands/kibana-setup.md
472472
:::
473473
::::
474474

@@ -478,21 +478,21 @@ links:
478478

479479
:::{link-card}
480480
title: Configuration and settings
481-
link: kibana://reference/kibana/configuration-reference.md
481+
link: kibana://reference/configuration-reference.md
482482
description: All kibana.yml settings and UI-configurable advanced settings.
483483
links:
484484
- label: General
485-
url: kibana://reference/kibana/configuration-reference/general-settings.md
485+
url: kibana://reference/configuration-reference/general-settings.md
486486
- label: Alerting
487-
url: kibana://reference/kibana/configuration-reference/alerting-settings.md
487+
url: kibana://reference/configuration-reference/alerting-settings.md
488488
- label: Security
489-
url: kibana://reference/kibana/configuration-reference/security-settings.md
489+
url: kibana://reference/configuration-reference/security-settings.md
490490
- label: Reporting
491-
url: kibana://reference/kibana/configuration-reference/reporting-settings.md
491+
url: kibana://reference/configuration-reference/reporting-settings.md
492492
- label: Monitoring
493-
url: kibana://reference/kibana/configuration-reference/monitoring-settings.md
493+
url: kibana://reference/configuration-reference/monitoring-settings.md
494494
- label: Advanced settings (UI)
495-
url: kibana://reference/kibana/advanced-settings.md
495+
url: kibana://reference/advanced-settings.md
496496
:::
497497

498498
:::{link-card}

0 commit comments

Comments
 (0)