-
Notifications
You must be signed in to change notification settings - Fork 25.6k
Adding more retriever examples to the documentation examples #116196
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
Adding more retriever examples to the documentation examples #116196
Conversation
Documentation preview: |
Pinging @elastic/es-docs (Team:Docs) |
Pinging @elastic/es-search-relevance (Team:Search Relevance) |
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.
Just some initial formatting fixes to pass CI and get URL preview generated :)
I'll do another pass tomorrow for copyediting, etc.
docs/reference/search/search-your-data/retrievers_examples.asciidoc
Outdated
Show resolved
Hide resolved
docs/reference/search/search-your-data/retrievers_examples.asciidoc
Outdated
Show resolved
Hide resolved
docs/reference/search/search-your-data/retrievers_examples.asciidoc
Outdated
Show resolved
Hide resolved
docs/reference/search/search-your-data/retrievers_examples.asciidoc
Outdated
Show resolved
Hide resolved
docs/reference/search/search-your-data/retrievers_examples.asciidoc
Outdated
Show resolved
Hide resolved
docs/reference/search/search-your-data/retrievers_examples.asciidoc
Outdated
Show resolved
Hide resolved
docs/reference/search/search-your-data/retrievers_examples.asciidoc
Outdated
Show resolved
Hide resolved
docs/reference/search/search-your-data/retrievers_examples.asciidoc
Outdated
Show resolved
Hide resolved
docs/reference/search/search-your-data/retrievers_examples.asciidoc
Outdated
Show resolved
Hide resolved
Co-authored-by: Liam Thompson <[email protected]>
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.
Some copyedits for consistency and simple phrasing where possible. Also tries to remove statements like "Now you can do x" because this will become stale fast.
I'd like for some dev peers to take a look at this PR too for technical feedback :)
docs/reference/search/search-your-data/retrievers_examples.asciidoc
Outdated
Show resolved
Hide resolved
docs/reference/search/search-your-data/retrievers_examples.asciidoc
Outdated
Show resolved
Hide resolved
docs/reference/search/search-your-data/retrievers_examples.asciidoc
Outdated
Show resolved
Hide resolved
docs/reference/search/search-your-data/retrievers_examples.asciidoc
Outdated
Show resolved
Hide resolved
docs/reference/search/search-your-data/retrievers_examples.asciidoc
Outdated
Show resolved
Hide resolved
docs/reference/search/search-your-data/retrievers_examples.asciidoc
Outdated
Show resolved
Hide resolved
docs/reference/search/search-your-data/retrievers_examples.asciidoc
Outdated
Show resolved
Hide resolved
docs/reference/search/search-your-data/retrievers_examples.asciidoc
Outdated
Show resolved
Hide resolved
Thank you a lot for the feedback and suggestions @leemthompo 🙏 |
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.
Nice work Panos - The examples are comprehensive and well thought 💯
Some notes on the overall tone and the ordering - but it could be just me 😅
docs/reference/search/search-your-data/retrievers-overview.asciidoc
Outdated
Show resolved
Hide resolved
docs/reference/search/search-your-data/retrievers-overview.asciidoc
Outdated
Show resolved
Hide resolved
docs/reference/search/search-your-data/retrievers-overview.asciidoc
Outdated
Show resolved
Hide resolved
docs/reference/search/search-your-data/retrievers_examples.asciidoc
Outdated
Show resolved
Hide resolved
docs/reference/search/search-your-data/retrievers_examples.asciidoc
Outdated
Show resolved
Hide resolved
docs/reference/search/search-your-data/retrievers_examples.asciidoc
Outdated
Show resolved
Hide resolved
@pmpailis @carlosdelest I wonder if it would be cleaner if these examples lived on a subpage to the retrievers overview? I think they might merit their own page. |
++ that's a nice idea. Tbf the retrievers overview page is getting pretty hard to navigate with the all the additional content. |
@elasticmachine update branch |
There are no new commits on the base branch. |
Co-authored-by: Liam Thompson <[email protected]>
docs/reference/search/search-your-data/retrievers-examples.asciidoc
Outdated
Show resolved
Hide resolved
…iidoc Co-authored-by: Liam Thompson <[email protected]>
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.
LGTM! Thanks for iterating. I've left a couple minor suggestions, plus a note about testing that can be done in a follow-up. 👍
docs/reference/search/search-your-data/retrievers-examples.asciidoc
Outdated
Show resolved
Hide resolved
Co-authored-by: Liam Thompson <[email protected]>
💔 Backport failed
You can use sqren/backport to manually backport by running |
Adding more examples to document retriever usage and newly available functionality.