-
Notifications
You must be signed in to change notification settings - Fork 266
PHPLIB-1279: Revise driver/extension terminology #1335
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
Prefer "extension" over "driver" when referring to ext-mongodb specifically. Also removes mention of Int64 having a private constructor.
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 one minor clarification.
@@ -67,10 +67,9 @@ MongoDB\\Exception\\UnexpectedValueException | |||
This exception is thrown when a command response from the server is | |||
malformed or not what the library expected. This exception means that an | |||
assertion in some operation, which abstracts a database command, has failed. | |||
It may indicate a corrupted BSON response or bug in the server, driver, or | |||
library. | |||
It may indicate a corrupted BSON response or bug in the server or driver. |
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.
Is driver referring to the extension, library or extension+library in this line?
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.
Any remaining references to "driver" should be taken to mean extension and/or library, where there is no need to differentiate.
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've targeted v1.17 for this as it's the oldest branch that doesn't conflict. I think it'd be reasonable to drop v1.16 entirely
I'd be very much in favour to drop old versions from the docs, especially if they conflict or need manual merges.
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
We can ignore rector in this branch. |
* Merge v1.16 into v1.17 (#1327) * PHPLIB-1279: Revise driver/extension terminology (#1335) Prefer "extension" over "driver" when referring to ext-mongodb specifically. Also removes mention of Int64 having a private constructor. * PHPLIB-1466: Remove obsolete "Type Map Limitations" --------- Co-authored-by: Jeremy Mikola <jmikola@gmail.com>
https://jira.mongodb.org/browse/PHPLIB-1279
https://jira.mongodb.org/browse/PHPLIB-1466
This updates references where we're discussing something specific to the extension. I've left "driver" in place for more general discussion about the PHP driver or for special topics such as "driver options" on Manager and Client objects.
I've targeted v1.17 for this as it's the oldest branch that doesn't conflict. I think it'd be reasonable to drop v1.16 entirely from https://www.mongodb.com/docs/php-library/current/ since we've had new releases following the original Giza -> Snooty port.