-
Notifications
You must be signed in to change notification settings - Fork 1.1k
PYTHON-3018 Add docs for removed methods from Collection #801
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
doc/api/pymongo/collection.rst
Outdated
|
||
Removed. Use :meth:`pymongo.collection.Collection.bulk_write` | ||
instead. Code like this:: | ||
batch = coll.initialize_(un)ordered_bulk_op() |
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 if it would be better to separate into two sections. Saying "(un)ordered" makes sense to me but might not be clear to the user.
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.
Instead of duplicating the docs from the migration guide, let's link to the guide itself. Something like this:
..versionchanged:: 4.0
Removed the insert, save, count, .... methods. See the <link to migration guide>.
We can put this in the Collection docstring.
parallel_scan, initialize_unordered_bulk_op, | ||
initialize_ordered_bulk_op, group, count, insert, save, | ||
update, remove, find_and_modify, and ensure_index methods. See the | ||
:ref:`pymongo4-migration-guide`. |
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.
Perfect, can you make a similar change for MongoClient and Database?
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.
Done.
@@ -503,6 +503,11 @@ def __init__( | |||
|
|||
.. seealso:: The MongoDB documentation on `connections <https://dochub.mongodb.org/core/connections>`_. | |||
|
|||
.. versionchanged:: 4.0 |
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.
Please combine this with the existing versionchanged below.
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.
Done.
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
No description provided.