-
Notifications
You must be signed in to change notification settings - Fork 784
MongoDB: document changes in 2.0.0 #4618
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
Note: I'm working on fixing the build error. |
3da0758
to
37994a8
Compare
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.
I have some questions and remarks.
@@ -56,6 +56,7 @@ | |||
</row> | |||
</thead> | |||
<tbody> | |||
&mongodb.changelog.tentative-return-types-enforced; |
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 think an example should be added to show that it is not necessary to add all return types with covariance. We can create a ticket to do this later.
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.
Yeah, we can consider doing this later. Let's see how many people struggle with the change.
A negative value for the <literal>"limit"</literal> option no longer | ||
implies &true; for the <literal>"singleBatch"</literal> option. To only | ||
receive a single batch of results, combine a positive | ||
<literal>"limit"</literal> value with the | ||
<literal>"singleBatch"</literal> option. |
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 like the way you move the documentation of the removed option so people using a legacy version of the driver can still find their description even if the doc is not versioned.
This adds documentation changes for MongoDB 2.0. Documentation for methods and classes that were removed has been preserved - however I have removed deprecated constants and options for brevity.
Classes and methods that were removed in 2.0 will be removed from the docs at a future date.