The shell (and some drivers) are specific that UpdateOne/UpdateMany must use update operators and that ReplaceOne must not.

To help users use the CRUD operations correctly and without confusion, the driver should similarly state such restrictions in the documentation.