Dedupe and clarify "Search your data" #213
Conversation
> Important: These docs now avoid duplicating content from core ES documentation to reduce maintenance overhead and prevent documentation drift. Instead, they focus on serverless-specific content and refer to core docs for implementation details. These docs were manually duplicated a looong time ago and are now incomplete and out of date. - Removed duplicated implementation guides - References core ES docs - Added tip for "bring your own vectors" tutorial - Removed duplicated implementation details - Points to core ES docs - Marked as duplicate/removed from navigation - Added Retrievers section - Simplified Query DSL explanation - References core ES docs - Rewritten for serverless context - Links to quickstart tutorials and notebooks - Points to core docs for concepts
|
A documentation preview will be available soon. Request a new doc build by commenting
If your PR continues to fail for an unknown reason, the doc build pipeline may be broken. Elastic employees can check the pipeline status here. |
There was a problem hiding this comment.
overall, not sure why the child pages stayed when the core message of the parent is "it works exactly the same as regular elasticsearch" - keeping the child pages sends a signal that these features work differently in serverless.
wonder if a better strategy would be "here are some key features we want to highlight" on that top level page, with links out.
| * What processes on my server take longer than 500 milliseconds to respond? | ||
| * What users on my network ran regsvr32.exe within the last week? | ||
| * What pages on my website contain a specific word or phrase? | ||
| You can also run searches using *Discover* in your project's UI. |
There was a problem hiding this comment.
can you link to discover docs here?
| @@ -1,26 +1,23 @@ | |||
| [[elasticsearch-search-your-data]] | |||
| = Search your data | |||
There was a problem hiding this comment.
these pages with children should always introduce their child pages
There was a problem hiding this comment.
unclear why you chose to keep this page
serverless/pages/knn-search.asciidoc
Outdated
long story short it would have taken more time to merge all this content and make it legible, rather than just an undifferentiated list of stuff, so for the moment there's a little pre-curation here before being sent into the jungles of the ES guide was rushing with this and the important thing is removing the out-of-date duplication, so can revisit in follow-up and set up redirects etc.
👍 |
Co-authored-by: shainaraskas <[email protected]>
|
Thanks feel free to merge |
Issue: https://github.com/elastic/search-docs-team/issues/226
Companion PR: #205
These docs now avoid duplicating content from core ES documentation to reduce maintenance overhead and prevent documentation drift. Instead, they focus on serverless-specific content and refer to core docs for implementation details.
These docs were manually duplicated a looong time ago and are now incomplete and out of date.
👀 URL preview
Summary of changes
search-your-data.asciidoc
search-your-data-the-search-api.asciidoc
knn-search.asciidoc
search-with-synonyms.asciidoc