Skip to content

Conversation

szabosteve
Copy link
Contributor

@szabosteve szabosteve commented Sep 10, 2025

PAGE PREVIEW

Overview

Related to https://github.com/elastic/docs-content-internal/issues/281

This PR repositions the message of the /search landing page. It emphasizes that the datastore and vector database capabilities are core use cases of the ES solution. Search is presented as one of several possible use cases of ES, rather than the defining use case.

TO DO

  • Update links in two files that reference /solutions/search.md#elasticsearch-serverless to point to H1

@szabosteve szabosteve added documentation Improvements or additions to documentation Team:Developer Issues owned by the Developer Docs Team v9.2.0 labels Sep 10, 2025
Copy link

github-actions bot commented Sep 10, 2025

🔍 Preview links for changed docs

@szabosteve szabosteve changed the title [SEARCH] Emphasizes the datastore capabilities of ES on landing page [ES] Emphasizes the datastore capabilities of ES on landing page Sep 17, 2025
Copy link

@jimczi jimczi left a comment

Choose a reason for hiding this comment

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

I left some minor comments on the nomenclature and naming.
I really like the focus on ES as a solution!

# The Elasticsearch solution

{{es}} enables you to build powerful search experiences for websites, applications, and enterprise data using Elastic's unified platform.
The {{es}} solution and serverless project type position {{es}} as a comprehensive platform: a scalable data store, a powerful search engine, and a vector database in one. At its core, {{es}} is a distributed datastore that can ingest, index, and manage various types of data in near real-time, making them both searchable and analyzable. With specialized user interfaces and tools, it provides the flexibility to create, deploy, and run a wide range of applications, from search to analytics to AI-driven solutions.
Copy link

Choose a reason for hiding this comment

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

Small nit: I wonder if the wording here should be about a scalable datastore that powers a search engine, a vector database and analytics in one?

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.

Looks great and I think we've discussed the main points 1 on 1 prior to the PR, just one thing struck me about the H1 and nav title

---

# Elasticsearch
# The Elasticsearch solution
Copy link
Contributor

Choose a reason for hiding this comment

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

Not strong opinion, but I'd lean towards this being: The Elasticsearch solution and search use case

and for the navigation_title, something like:

  • Elasticsearch & Search
  • Elasticsearch for search

Copy link
Contributor

@benironside benironside 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 a great addition to the docs! Left some suggestions for your consideration, but nothing blocking. Hope they are helpful!

* **Search relevance tools**: Purpose-built UIs for managing synonyms, query rules, and other relevance-enhancing features
* **AI toolkit**: RAG Playground and inference endpoints management for building AI-enhanced applications
* **Complete {{es}} REST API**: Full access to {{es}}'s comprehensive APIs for indexing, searching, and managing data
* **Deployment flexibility**: Run in Elastic Cloud, Elastic Serverless, or self-managed environments with consistent interfaces
Copy link
Contributor

Choose a reason for hiding this comment

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

Maybe a good place to use attributes {{ecloud}} and {{serverless-full}}?


### Datastore and vector database

You can index many types of data, keep them stored efficiently, searchable, and analyzable. If all you need is a reliable and scalable datastore, you can use {{es}} that way without adding anything else. All of {{es}}’s advanced capabilities start with its role as a [data store](/manage-data/data-store.md). Examples include, but are not limited to:
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
You can index many types of data, keep them stored efficiently, searchable, and analyzable. If all you need is a reliable and scalable datastore, you can use {{es}} that way without adding anything else. All of {{es}}’s advanced capabilities start with its role as a [data store](/manage-data/data-store.md). Examples include, but are not limited to:
You can index many types of data to store it efficiently for search and analysis. If all you need is a reliable and scalable datastore, you can use {{es}}'s basic functionality without advanced configuration. All of {{es}}’s advanced capabilities start with its role as a [data store](/manage-data/data-store.md). Supported data types include, but are not limited to:

As written, it sounded to me like the "Examples" will be advanced capabilities, not types of data.
Not sure my suggestions for the second sentence are accurate.

szabosteve and others added 5 commits September 24, 2025 17:01
Co-authored-by: Benjamin Ironside Goldstein <[email protected]>
Co-authored-by: Benjamin Ironside Goldstein <[email protected]>
Co-authored-by: Benjamin Ironside Goldstein <[email protected]>
Co-authored-by: Benjamin Ironside Goldstein <[email protected]>
Co-authored-by: Benjamin Ironside Goldstein <[email protected]>
Co-authored-by: Benjamin Ironside Goldstein <[email protected]>
@szabosteve
Copy link
Contributor Author

Update (25 Sep)

The terms (and less likely the content focus) might change after the offsite (22–26 Sep). That’s why I haven’t edited the page further.

The PR can be amended based on @serenachou’s feedback about the direction defined at the offsite:

  • If the changes are limited to terminology and the focus stays the same, @leemthompo will update this PR when time permits and merge it.
  • If more substantial changes are needed (and can wait), I’ll handle them when I’m back (early November) so we don’t waste anyone’s time.

CC @lcawl

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation Team:Developer Issues owned by the Developer Docs Team v9.2.0

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants