Skip to content

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

Merged
merged 2 commits into from
Jun 6, 2024

Conversation

jmikola
Copy link
Member

@jmikola jmikola commented Jun 4, 2024

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.

jmikola added 2 commits June 4, 2024 15:06
Prefer "extension" over "driver" when referring to ext-mongodb specifically.

Also removes mention of Int64 having a private constructor.
@jmikola jmikola requested a review from a team as a code owner June 4, 2024 19:12
@jmikola jmikola requested review from alcaeus, norareidy and bisht2050 and removed request for alcaeus June 4, 2024 19:12
Copy link

@bisht2050 bisht2050 left a 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.

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?

Copy link
Member Author

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.

Copy link
Member

@alcaeus alcaeus left a 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.

Copy link
Contributor

@norareidy norareidy left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@alcaeus
Copy link
Member

alcaeus commented Jun 6, 2024

We can ignore rector in this branch.

@jmikola jmikola merged commit 28aabbe into mongodb:v1.17 Jun 6, 2024
12 of 13 checks passed
@jmikola jmikola deleted the 1.17-phplib-1279 branch June 6, 2024 17:22
jmikola added a commit that referenced this pull request Jun 6, 2024
* 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>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants