-
Notifications
You must be signed in to change notification settings - Fork 156
[ES] Emphasizes the datastore capabilities of ES on landing page #2892
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
base: main
Are you sure you want to change the base?
Conversation
🔍 Preview links for changed docs |
…into szabosteve/dci-281
…into szabosteve/dci-281
There was a problem hiding this 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. |
There was a problem hiding this comment.
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?
There was a problem hiding this 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 |
There was a problem hiding this comment.
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
There was a problem hiding this 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 |
There was a problem hiding this comment.
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: |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
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.
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]>
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:
CC @lcawl |
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
/solutions/search.md#elasticsearch-serverless
to point to H1