DOCSP-43074: Specify a Query #30
Merged
Conversation
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
rustagir
requested changes
Sep 12, 2024
source/read/specify-a-query.txt
Outdated
Comment on lines
25
to
26
| You can refine the set of documents that a query returns by creating a | ||
| **query filter**. A query filter is an expression that specifies the search |
There was a problem hiding this comment.
Suggested change
| You can refine the set of documents that a query returns by creating a | |
| **query filter**. A query filter is an expression that specifies the search | |
| You can define a **query filter** to retrieve specific documents from a collection | |
| when performing a query. A query filter is an expression that specifies the search |
source/read/specify-a-query.txt
Outdated
Comment on lines
28
to
30
| In a query filter, you can prompt the driver to search for documents with an | ||
| exact match to your query, or you can compose query filters to express more | ||
| complex matching criteria. |
There was a problem hiding this comment.
Suggested change
| In a query filter, you can prompt the driver to search for documents with an | |
| exact match to your query, or you can compose query filters to express more | |
| complex matching criteria. | |
| By defining a query filter, you can direct the driver to search for documents with an | |
| exact match to your query, or you can compose query filters to express more | |
| complex matching criteria. |
source/read/specify-a-query.txt
Outdated
Comment on lines
32
to
53
| Sample Data | ||
| ~~~~~~~~~~~ | ||
|
|
||
| The examples in this guide run operations on a collection called | ||
| ``fruits`` that contains the following documents: | ||
|
|
||
| .. code-block:: json | ||
|
|
||
| { "_id": 1, "name": "apples", "quantity": 5, "rating": 3, "color": "red", "type": ["fuji", "honeycrisp"] }, | ||
| { "_id": 2, "name": "bananas", "quantity": 7, "rating": 4, "color": "yellow", "type": ["cavendish"] }, | ||
| { "_id": 3, "name": "oranges", "quantity": 6, "rating": 2, "type": ["naval", "mandarin"] }, | ||
| { "_id": 4, "name": "pineapple", "quantity": 3, "rating": 5, "color": "yellow" }, | ||
|
|
||
| The following code example shows how to create a database and collection, then | ||
| insert the sample documents into your collection: | ||
|
|
||
| .. literalinclude:: /includes/read/specify-a-query.c | ||
| :start-after: start-sample-data | ||
| :end-before: end-sample-data | ||
| :language: c | ||
| :dedent: | ||
| :copyable: |
There was a problem hiding this comment.
Q: Should we follow convention used in other pages/standardizations to use the Atlas sample data when possible instead of using generated data?
There was a problem hiding this comment.
Can change to the restaurants collection.
EDIT: will use movies instead
rustagir
approved these changes
Sep 16, 2024
source/read/distinct.txt
Outdated
| .. TODO | ||
| .. For more information about | ||
| .. creating a query filter, see :ref:`c-specify-query`. | ||
| For more information about creating a query filter, see :ref:`c-specify-query`. |
There was a problem hiding this comment.
Suggested change
| For more information about creating a query filter, see :ref:`c-specify-query`. | |
| To learn more about creating query filters, see :ref:`c-specify-query`. |
| .. output:: | ||
| :visible: false | ||
|
|
||
| { "_id" : { "$oid" : "..." }, "title" : "Wild and Woolly", "type" : "movie", ... } |
There was a problem hiding this comment.
S: can truncate these results further
Suggested change
| { "_id" : { "$oid" : "..." }, "title" : "Wild and Woolly", "type" : "movie", ... } | |
| { "_id" : ..., "title" : "Wild and Woolly", "type" : "movie", ... } |
source/read/specify-a-query.txt
Outdated
Comment on lines
81
to
82
| parameter to the ``mongoc_collection_find_with_opts()`` function. The code returns all documents with a | ||
| ``year`` field value greater than ``2015``. |
There was a problem hiding this comment.
Suggested change
| parameter to the ``mongoc_collection_find_with_opts()`` function. The code returns all documents with a | |
| ``year`` field value greater than ``2015``. | |
| parameter to the ``mongoc_collection_find_with_opts()`` function. The code returns all documents in which | |
| the value of the ``year`` field is greater than ``2015``. |
There was a problem hiding this comment.
Use this phrasing where applicable
source/read/specify-a-query.txt
Outdated
Comment on lines
249
to
250
| To learn more about retrieving documents with the {+driver-short+}, see | ||
| :ref:`c-retrieve`. |
There was a problem hiding this comment.
S: avoid "with"
Suggested change
| To learn more about retrieving documents with the {+driver-short+}, see | |
| :ref:`c-retrieve`. | |
| To learn more about using the driver to retrieve documents, see | |
| :ref:`c-retrieve`. |
✅ Deploy Preview for docs-c ready!
To edit notification comments on pull requests, go to your Netlify site configuration. |
kevinAlbs
approved these changes
Sep 16, 2024
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Pull Request Info
PR Reviewing Guidelines
JIRA - https://jira.mongodb.org/browse/DOCSP-43074
Staging - https://preview-mongodbmcmorisi.gatsbyjs.io/c/DOCSP-43074-specify-query/read/specify-a-query/
Self-Review Checklist