Skip to content

Search: index generated API versions and product landings - #3897

Draft
reakaleek wants to merge 3 commits into
mainfrom
cursor/842c3505
Draft

Search: index generated API versions and product landings#3897
reakaleek wants to merge 3 commits into
mainfrom
cursor/842c3505

Conversation

@reakaleek

Copy link
Copy Markdown
Member

Why

  • Search currently indexes only one API spec version, so previous majors are missing from results. docs-eng-team#724
  • Queries such as "elasticsearch api" should hit the product overview, not a random operation whose title ends with the product name.

What

  • When assembler-api-explorer is on, search indexes every discovered spec version plus one product landing per version, and the sitemap includes generated API HTML URLs.
  • When the flag is off, OpenAPI search export is skipped and /docs/api/ stays out of the sitemap.

Notes

  • The old CloudFront elasticsearch/kibana search fallback is removed. Production will have no API search hits until the flag is on (docs-eng-team#725).
  • Tag, type, and catalog pages stay out of search. They remain in the sitemap when the flag is on.
  • Landing pages rank above operations (depth 10/30 vs 20/40) so the product overview wins for product-name queries.

Made with Cursor

reakaleek and others added 3 commits August 20, 2026 12:22
Search hits and sitemap.xml must use the same URLs as generated API HTML, including previous majors.

Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>
Co-authored-by: Cursor <cursoragent@cursor.com>
Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>
Co-authored-by: Cursor <cursoragent@cursor.com>
A query for elasticsearch api should hit the product overview, not a random operation.

Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.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

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant