-
Notifications
You must be signed in to change notification settings - Fork 2.2k
docs: add explanation on crud usage #3486
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
Conversation
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.
If the linking happens in the next step: LGTM
Codecov Report
@@ Coverage Diff @@
## master #3486 +/- ##
==========================================
- Coverage 90.12% 89.57% -0.56%
==========================================
Files 151 151
Lines 11070 11070
==========================================
- Hits 9977 9916 -61
- Misses 1093 1154 +61
Flags with carried forward coverage won't be shown. Click here to find out more.
Continue to review full report at Codecov.
|
Latency summaryCurrent PR yields:
Breakdown
Backed by latency-tracking. Further commits will update this comment. |
@hanxiao Headers need to be in Title Case, afaik. https://en.wikipedia.org/wiki/Title_case Also, the commit message is invalid |
c7ca77c
to
1c71db8
Compare
@hanxiao Fixed. Please re-approve |
📝 Docs are deployed on https://docs-crud-endpoints--jina-docs.netlify.app 🎉 |
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 a few minor tweaks. Otherwise LGTM 👍
| **D**elete | `/delete` | Storage | | ||
|
||
The Create, Update, Delete are implemented by the Storage Indexers, while the Read operation is implemented in the `/search` endpoints in the Search Indexers. | ||
The `/search` endpoints do not correspond perfectly with the Read operation, as it _searches_ for sim 8000 ilar results, and not return a specific Document by id. |
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.
- and does not return...
| **U**pdate | `/update` | Storage | | ||
| **D**elete | `/delete` | Storage | | ||
|
||
The Create, Update, Delete are implemented by the Storage Indexers, while the Read operation is implemented in the `/search` endpoints in the Search Indexers. |
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.
- The C, U, D operations
|
||
The Create, Update, Delete are implemented by the Storage Indexers, while the Read operation is implemented in the `/search` endpoints in the Search Indexers. | ||
The `/search` endpoints do not correspond perfectly with the Read operation, as it _searches_ for similar results, and not return a specific Document by id. | ||
Some Storage Indexers do implement a `/fill_embedding` endpoint, which function as a Read by id. |
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.
- which functions
This is required in order to explain what a Storage vs Searcher implements (generally).