Skip to content

Conversation

lcawl
Copy link
Contributor

@lcawl lcawl commented Jun 26, 2025

This PR aims to port content from https://www.elastic.co/getting-started/enterprise-search/build-a-semantic-search-experience into the https://www.elastic.co/docs/solutions/search/get-started section of the documentation.

Some significant changes include:

  • Rather than requiring a crawler to ingest sample documents, it uses the ones provided in the index creation workflow (since we want to defer the complexity of ingestion for early users). If the crawler example needs to be ported to the docs, that can be accomplished in a more advanced workflow.
  • Rather than covering both semantic search and hybrid search, it covers only the former. Hybrid search will be covered in a separate page.
  • Rather than Query DSL examples, it uses ES|QL in Discover.
  • Since the steps apply to both Serverless and Stack contexts with minor variations, those variations are both covered.

NOTE: To align with #1929, the new semantic search page is grouped into a quickstart section. I think after all the getting-started guides are migrated into this section we can revisit how/if the API quickstarts can also be included in this section.

Preview

https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/1922/solutions/search/get-started/semantic-search

@lcawl lcawl added the Team:Projects Issues owned by the Docs Org label Jun 26, 2025
Copy link

github-actions bot commented Jun 26, 2025

🔍 Preview links for changed docs:

🔔 The preview site may take up to 3 minutes to finish building. These links will become live once it completes.

@lcawl lcawl force-pushed the lcawl/gs-search branch from 8168394 to 73aaed7 Compare June 28, 2025 03:48
@lcawl lcawl marked this pull request as ready for review June 28, 2025 05:55
@lcawl lcawl requested review from a team as code owners June 28, 2025 05:55
@lcawl lcawl requested review from jmikell821 and theletterf June 28, 2025 05:56
@theletterf
Copy link
Contributor

Love the overall structure and the use of the stepper!

@florent-leborgne
Copy link
Contributor

+1 on the stepper

You can hosts gifs on Contentstack as well in case we don't want too heavy files stored in GH

Copy link
Contributor

@szabosteve szabosteve left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is great, thank you for creating it! I left a couple of comments, mostly nits.

@lcawl
Copy link
Contributor Author

lcawl commented Jun 30, 2025

You can hosts gifs on Contentstack as well in case we don't want too heavy files stored in GH

Thanks @florent-leborgne! I've switched to linking to contentstack in 6afc299

Copy link
Contributor

@leemthompo leemthompo left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I just had a few ideas and observations reading through this :)

Copy link

github-actions bot commented Jul 4, 2025

@lcawl lcawl marked this pull request as draft July 4, 2025 01:05
@lcawl lcawl marked this pull request as ready for review July 8, 2025 03:04
@lcawl lcawl requested a review from a team as a code owner July 8, 2025 03:04
Copy link
Contributor

@leemthompo leemthompo left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM with a few straggling optionals :)

NOTE: To align with #1929, the new semantic search page is grouped into a quickstart section. I think after all the getting-started guides are migrated into this section we can revisit how/if the API quickstarts can also be included in this section.

My instinct is that we should group them together as soon as possible, feels a little hidden in this new section. They're all hands-on guides, just using different interfaces.

@lcawl lcawl changed the title Add Elasticsearch semantic search getting started guide Add Elasticsearch semantic search quickstart guide Jul 8, 2025
@lcawl lcawl changed the title Add Elasticsearch semantic search quickstart guide Add Elasticsearch semantic search quickstart Jul 8, 2025
@lcawl lcawl merged commit 6b10aea into main Jul 9, 2025
9 checks passed
@lcawl lcawl deleted the lcawl/gs-search branch July 9, 2025 21:56
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Team:Projects Issues owned by the Docs Org

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants