Skip to content

Add Elasticsearch semantic search getting started guide #1922

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 15 commits into
base: main
Choose a base branch
from

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.
  • In addition to the Query DSL examples, there's now an example of using ES|QL in Discover.

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

@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 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.

"_id": "Pp0MtJcBZjjo1YKoXkWH",
"_score": 11.389743,
"_source": {
"text": "Rocky Mountain National Park ...
Copy link
Contributor

Choose a reason for hiding this comment

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

Should this be closed?

Suggested change
"text": "Rocky Mountain National Park ...
"text": "Rocky Mountain National Park ..."

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.

4 participants