Skip to content

Multi Page#7

Merged
ThomThomson merged 6 commits into
mainfrom
multi-page
May 5, 2026
Merged

Multi Page#7
ThomThomson merged 6 commits into
mainfrom
multi-page

Conversation

@ThomThomson
Copy link
Copy Markdown
Collaborator

This PR splits the spec generation and the html output into multiple files. One for Dashboards, one for Visualizations, and one for the static introduction. This lowers the load on the client when rendering the site.

This PR also contains some changes to prune content from the spec more aggressively.
Screenshot 2026-05-04 at 4 50 08 PM

@florent-leborgne for vis. Now that we have the top navigation, it might be nice to show all the paths for Dashboards / Visualizations up front instead of having them under an accordion.

Co-authored-by: Cursor <cursoragent@cursor.com>
@ThomThomson ThomThomson merged commit f945ea7 into main May 5, 2026
3 checks passed
florent-leborgne added a commit to elastic/docs-content that referenced this pull request May 6, 2026
## Summary

Updates 2 links in the _Create dashboards programmatically_ overview
page following the split of the dashboards-api-spec into separate pages
per
[elastic/dashboards-api-spec#7](elastic/dashboards-api-spec#7).

Previously both APIs were on a single Redoc page, so `#tag/Dashboards`
and `#tag/Visualizations` worked as same-page anchors. With the split,
each API has its own page and the links need to include the page
segment:

| Before | After |
|--------|-------|
| `https://elastic.github.io/dashboards-api-spec/#tag/Dashboards` |
`https://elastic.github.io/dashboards-api-spec/dashboards#tag/Dashboards`
|
| `https://elastic.github.io/dashboards-api-spec/#tag/Visualizations` |
`https://elastic.github.io/dashboards-api-spec/visualizations#tag/Visualizations`
|

> **Note**: This PR should be merged after elastic/dashboards-api-spec#7
lands.

Made with [Cursor](https://cursor.com)

---------

Co-authored-by: Cursor <cursoragent@cursor.com>
florent-leborgne added a commit to elastic/kibana that referenced this pull request May 6, 2026
…zations pages (#267789)

## Summary

Fixes 12 broken links in `kibana.overlays.bump_slim.yaml` following the
split of the dashboards-api-spec into separate pages per
[elastic/dashboards-api-spec#7](elastic/dashboards-api-spec#7).

The placeholder stubs for each Dashboards and Visualizations operation
link to `#tag/Dashboards` and `#tag/Visualizations`. With the page
split, these need the page segment prepended:

| Before | After |
|--------|-------|
| `https://elastic.github.io/dashboards-api-spec/#tag/Dashboards` |
`https://elastic.github.io/dashboards-api-spec/dashboards#tag/Dashboards`
|
| `https://elastic.github.io/dashboards-api-spec/#tag/Visualizations` |
`https://elastic.github.io/dashboards-api-spec/visualizations#tag/Visualizations`
|

> **Note**: Should be merged after elastic/dashboards-api-spec#7 lands,
alongside #265962.

Made with [Cursor](https://cursor.com)

Co-authored-by: Cursor <cursoragent@cursor.com>
florent-leborgne added a commit to elastic/kibana that referenced this pull request May 6, 2026
…zations API pages (#267776)

## Summary

Fixes 6 broken cross-page anchor links in the dashboards and
visualizations API overlays, following the split of the combined spec
into separate pages (see elastic/dashboards-api-spec#7).

Previously both pages were rendered together, so
`#operation/post-visualizations` and `#operation/post-dashboards` worked
as same-page anchors. Now that each API has its own page,
cross-references need to include the sibling page in the URL.

**`dashboards.overlays.yaml`** — 3 links updated:
- `#operation/post-visualizations` →
`visualizations#tag/Visualizations/operation/post-visualizations`

**`visualizations.overlays.yaml`** — 3 links updated:
- `#operation/post-dashboards` →
`dashboards#tag/Dashboards/operation/post-dashboards`

Same-page self-links (`#operation/post-dashboards` on the dashboards
page and `#operation/post-visualizations` on the visualizations page)
are unchanged.

Made with [Cursor](https://cursor.com)

Co-authored-by: Cursor <cursoragent@cursor.com>
kibanamachine added a commit to elastic/kibana that referenced this pull request May 6, 2026
…isualizations API pages (#267776) (#267974)

# Backport

This will backport the following commits from `main` to `9.4`:
- [fix(oas): update cross-page anchor links for split
dashboards/visualizations API pages
(#267776)](#267776)

<!--- Backport version: 9.6.6 -->

### Questions ?
Please refer to the [Backport tool
documentation](https://github.com/sorenlouv/backport)

<!--BACKPORT [{"author":{"name":"Florent
LB","email":"florent.leborgne@elastic.co"},"sourceCommit":{"committedDate":"2026-05-06T13:20:55Z","message":"fix(oas):
update cross-page anchor links for split dashboards/visualizations API
pages (#267776)\n\n## Summary\n\nFixes 6 broken cross-page anchor links
in the dashboards and\nvisualizations API overlays, following the split
of the combined spec\ninto separate pages (see
elastic/dashboards-api-spec#7).\n\nPreviously both pages were rendered
together, so\n`#operation/post-visualizations` and
`#operation/post-dashboards` worked\nas same-page anchors. Now that each
API has its own page,\ncross-references need to include the sibling page
in the URL.\n\n**`dashboards.overlays.yaml`** — 3 links updated:\n-
`#operation/post-visualizations`
→\n`visualizations#tag/Visualizations/operation/post-visualizations`\n\n**`visualizations.overlays.yaml`**
— 3 links updated:\n- `#operation/post-dashboards`
→\n`dashboards#tag/Dashboards/operation/post-dashboards`\n\nSame-page
self-links (`#operation/post-dashboards` on the dashboards\npage and
`#operation/post-visualizations` on the visualizations page)\nare
unchanged.\n\nMade with [Cursor](https://cursor.com)\n\nCo-authored-by:
Cursor
<cursoragent@cursor.com>","sha":"316994f2a7b2120c19e6cd23895cf14653797964","branchLabelMapping":{"^v9.5.0$":"main","^v(\\d+).(\\d+).\\d+$":"$1.$2"}},"sourcePullRequest":{"labels":["Team:Docs","release_note:skip","docs","APIDocs","backport:version","v9.4.0","v9.5.0"],"title":"fix(oas):
update cross-page anchor links for split dashboards/visualizations API
pages","number":267776,"url":"https://github.com/elastic/kibana/pull/267776","mergeCommit":{"message":"fix(oas):
update cross-page anchor links for split dashboards/visualizations API
pages (#267776)\n\n## Summary\n\nFixes 6 broken cross-page anchor links
in the dashboards and\nvisualizations API overlays, following the split
of the combined spec\ninto separate pages (see
elastic/dashboards-api-spec#7).\n\nPreviously both pages were rendered
together, so\n`#operation/post-visualizations` and
`#operation/post-dashboards` worked\nas same-page anchors. Now that each
API has its own page,\ncross-references need to include the sibling page
in the URL.\n\n**`dashboards.overlays.yaml`** — 3 links updated:\n-
`#operation/post-visualizations`
→\n`visualizations#tag/Visualizations/operation/post-visualizations`\n\n**`visualizations.overlays.yaml`**
— 3 links updated:\n- `#operation/post-dashboards`
→\n`dashboards#tag/Dashboards/operation/post-dashboards`\n\nSame-page
self-links (`#operation/post-dashboards` on the dashboards\npage and
`#operation/post-visualizations` on the visualizations page)\nare
unchanged.\n\nMade with [Cursor](https://cursor.com)\n\nCo-authored-by:
Cursor
<cursoragent@cursor.com>","sha":"316994f2a7b2120c19e6cd23895cf14653797964"}},"sourceBranch":"main","suggestedTargetBranches":["9.4"],"targetPullRequestStates":[{"branch":"9.4","label":"v9.4.0","branchLabelMappingKey":"^v(\\d+).(\\d+).\\d+$","isSourceBranch":false,"state":"NOT_CREATED"},{"branch":"main","label":"v9.5.0","branchLabelMappingKey":"^v9.5.0$","isSourceBranch":true,"state":"MERGED","url":"https://github.com/elastic/kibana/pull/267776","number":267776,"mergeCommit":{"message":"fix(oas):
update cross-page anchor links for split dashboards/visualizations API
pages (#267776)\n\n## Summary\n\nFixes 6 broken cross-page anchor links
in the dashboards and\nvisualizations API overlays, following the split
of the combined spec\ninto separate pages (see
elastic/dashboards-api-spec#7).\n\nPreviously both pages were rendered
together, so\n`#operation/post-visualizations` and
`#operation/post-dashboards` worked\nas same-page anchors. Now that each
API has its own page,\ncross-references need to include the sibling page
in the URL.\n\n**`dashboards.overlays.yaml`** — 3 links updated:\n-
`#operation/post-visualizations`
→\n`visualizations#tag/Visualizations/operation/post-visualizations`\n\n**`visualizations.overlays.yaml`**
— 3 links updated:\n- `#operation/post-dashboards`
→\n`dashboards#tag/Dashboards/operation/post-dashboards`\n\nSame-page
self-links (`#operation/post-dashboards` on the dashboards\npage and
`#operation/post-visualizations` on the visualizations page)\nare
unchanged.\n\nMade with [Cursor](https://cursor.com)\n\nCo-authored-by:
Cursor
<cursoragent@cursor.com>","sha":"316994f2a7b2120c19e6cd23895cf14653797964"}}]}]
BACKPORT-->

Co-authored-by: Florent LB <florent.leborgne@elastic.co>
Co-authored-by: Cursor <cursoragent@cursor.com>
ersin-erdal pushed a commit to ersin-erdal/kibana that referenced this pull request May 6, 2026
…zations API pages (elastic#267776)

## Summary

Fixes 6 broken cross-page anchor links in the dashboards and
visualizations API overlays, following the split of the combined spec
into separate pages (see elastic/dashboards-api-spec#7).

Previously both pages were rendered together, so
`#operation/post-visualizations` and `#operation/post-dashboards` worked
as same-page anchors. Now that each API has its own page,
cross-references need to include the sibling page in the URL.

**`dashboards.overlays.yaml`** — 3 links updated:
- `#operation/post-visualizations` →
`visualizations#tag/Visualizations/operation/post-visualizations`

**`visualizations.overlays.yaml`** — 3 links updated:
- `#operation/post-dashboards` →
`dashboards#tag/Dashboards/operation/post-dashboards`

Same-page self-links (`#operation/post-dashboards` on the dashboards
page and `#operation/post-visualizations` on the visualizations page)
are unchanged.

Made with [Cursor](https://cursor.com)

Co-authored-by: Cursor <cursoragent@cursor.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants