-
Notifications
You must be signed in to change notification settings - Fork 10
DOCSP-41161: Builders landing page #28
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
✅ Deploy Preview for docs-kotlin-sync ready!
To edit notification comments on pull requests, go to your Netlify site configuration. |
source/builders.txt
Outdated
This section describes three methods of fetching the ``email`` field values of documents | ||
in the ``users`` collection that meet the following criteria: |
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 section describes three methods of fetching the ``email`` field values of documents | |
in the ``users`` collection that meet the following criteria: | |
This section provides three equivalent ways to fetch the ``email`` field values of documents | |
in the ``users`` collection that meet the following criteria: |
source/includes/builders/builders.kt
Outdated
// start-find | ||
val filter = Document("gender", "female").append("age", Document("\$gt", 29)) | ||
val projection = Document("_id", 0).append("email", 1) | ||
val results = collection.find<Result>(filter).projection(projection) |
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.
val results = collection.find<Result>(filter).projection(projection) | |
val results = collection.find<Email>(filter).projection(projection) |
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 with some last comments
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 a couple of comments for consideration.
source/builders.txt
Outdated
Overview | ||
-------- | ||
|
||
This page describes how to implement the builders pattern in your code and describes |
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.
Nit: This seems a little verbose. In short its about using builders to help build operations in a less verbose way than using Documents.
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.
For further clarification, do you think the entire Overview section is too verbose?
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.
Will add suggesions
source/builders.txt
Outdated
.. _kotlin-sync-builders: | ||
|
||
=============================== | ||
Implement Builders Code Pattern |
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 sure this title makes sense - users aren't implementing builders we are consuming them.
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.
@mcmorisi I've added some suggestions which need some work but simplify the language around the builders / helpers.
source/builders.txt
Outdated
Overview | ||
-------- | ||
|
||
This page describes how to implement the builders pattern in your code and describes |
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.
Will add suggesions
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.
One nit then LGTM
source/builders.txt
Outdated
Overview | ||
-------- | ||
|
||
This page describes how to the various available builders in your code and describes |
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 page describes how to the various available builders in your code and describes | |
This page describes how to used the various available builders in your code and describes |
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!
Adapted from the coroutine builders page, did some trimming and updating.
Pull Request Info
PR Reviewing Guidelines
JIRA - https://jira.mongodb.org/browse/DOCSP-41161
Staging - https://preview-mongodbmcmorisi.gatsbyjs.io/kotlin-sync/DOCSP-41161-builders/builders/
Self-Review Checklist