[DOCS-5284] slight tweak to blurb re: upsertFields option for mongoimport Created: 25/Apr/15  Updated: 24/Feb/16  Resolved: 07/May/15

Status: Closed
Project: Documentation
Component/s: None
Affects Version/s: None
Fix Version/s: mongodb-3.0

Type: Bug Priority: Major - P3
Reporter: Kay Kim (Inactive) Assignee: Allison Reinheimer Moore
Resolution: Done Votes: 0
Labels: None
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original Estimate: Not Specified

Participants:
Days since reply: 8 years, 40 weeks, 6 days ago

 Description   

Given that it's a change of behavior, I would also put the blurb about when using --upsertFields, you don't need --upsert in the upsertFields section as well.
Basically, if you're an existing user, you might not read the --upsert flag section (although, visually, it's just above, but one never knows how what's displayed on screen).

Also, I'd tweak the wording a bit. So currently we state:

Changed in version 3.0.0: --upsert is no longer needed when specifying upserts. Use --upsertFields, which produces the same behavior.

But, if I take the first sentence on its own, it's not quite true. You don't need --upsert if you're not using --upsertFields. But, if I'm fine using _id field as the field to check for existence and so I don't explicitly state the --upsertFields, the --upsert should be fine. Steering people to prefer --upsertFields is fine, so if you want to go with something like (the following is just blurbage, so feel free to edit or change wholesale at will)

Using --upsertFields now implies --upsert, as such, you may prefer to use --upsertFields instead of --upsert.



 Comments   
Comment by Githook User [ 07/May/15 ]

Author:

{u'username': u'schmalliso', u'name': u'Allison Moore', u'email': u'allison.moore@10gen.com'}

Message: DOCS-5284: improves upsert/upsertFields wording

Signed-off-by: kay <kay.kim@10gen.com>
Branch: master
https://github.com/mongodb/docs/commit/dab0ce17506ce9df7e4ebbeb72bfa8278356e49e

Generated at Thu Feb 08 07:50:01 UTC 2024 using Jira 9.7.1#970001-sha1:2222b88b221c4928ef0de3161136cc90c8356a66.