DOCSP-47059: Work with BSON

[norareidy]

Pull Request Info

PR Reviewing Guidelines

Edits the existing BSON page for style guide alignment and adds some content.

JIRA - https://jira.mongodb.org/browse/DOCSP-47059

Staging Links

data-formats/modeling-bson-data

Self-Review Checklist

• Is this free of any warnings or errors in the RST?
• Did you run a spell-check?
• Did you run a grammar-check?
• Are all the links working?
• Are the facets and meta keywords accurate?
• Are the page titles greater than 20 characters long and SEO relevant?
• Did you add redirects?

[netlify]

✅ Deploy Preview for docs-php-library ready!

Name	Link
🔨 Latest commit	36ac8c3
🔍 Latest deploy log	https://app.netlify.com/projects/docs-php-library/deploys/6841d8c38f389f0008bd6c60
😎 Deploy Preview	https://deploy-preview-263--docs-php-library.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify project configuration.

[rustagir]

S: to resolve vale error

Suggested change

	supports additional types, including dates, different-sized integers, ``ObjectId``
	also supports other types, such as dates, different-sized integers, ``ObjectId``

[rustagir]

Good work, There are a few areas that I wanted to see some more context + some style guide fixes

[rustagir]

S: Use API links

[rustagir]

Suggested change

	For a complete list of supported BSON types, see :manual:`BSON Types
	</reference/bson-types>` in the {+mdb-server+} manual.
	To view a complete list of supported BSON types, see :manual:`BSON Types
	</reference/bson-types>` in the {+mdb-server+} manual.

[rustagir]

S: style guide

Suggested change

	You can create a BSON document by using the same notation you use to create an
	You can create a BSON document by using the same notation that you use to create an

[rustagir]

Suggested change

	You can modify the contents of a BSON document by using the same notation you use to
	modify an associative array in {+language+}. This example makes the following changes
	to the :ref:`sample BSON document <php-bson-sample>`:
	You can modify the contents of a BSON document by using the same notation that you use to
	modify an associative array in {+language+}. This example makes the following changes
	to the :ref:`sample BSON document <php-bson-sample>`:

[rustagir]

S: consider using a name that doesn't include a char that needs escaping, unless you specifically want to demonstrate this (which is good too!)

[norareidy]

Updated, I don't think it's necessary to demonstrate

[rustagir]

S: explain what is special/expected by defining the class this way

[rustagir]

Suggested change

	you must specify serialization logic by defining the ``bsonSerialize()``
	and ``bsonUnserialize()`` methods.
	you must specify serialization logic by defining the ``bsonSerialize()``
	and ``bsonUnserialize()`` methods in your class definition.

[rustagir]

S: consider adding highlighting for the methods of interest

[rustagir]

Suggested change

	Enums cannot implement the ``MongoDB\BSON\Unserializable`` and
	``MongoDB\BSON\Persistable`` interfaces, since enum cases have no
	state and cannot be instantiated like class objects. However, pure and backed
	enums can implement ``MongoDB\BSON\Serializable``, which you can use to
	override the default enum serialization behavior.
	Enums cannot implement the ``MongoDB\BSON\Unserializable`` and
	``MongoDB\BSON\Persistable`` interfaces because enum cases have no
	state and cannot be instantiated like class objects. However, pure and backed
	enums can implement ``MongoDB\BSON\Serializable``, which you can use to
	override the default enum serialization behavior.

[rustagir]

S: consider demonstrating an example as you did in the previous section of the serialization roundtrip

[rustagir]

This looks good and addresses my concern!

[rustagir]

looks great! thanks for implementing all the feedback

[rustagir]

S: simplify

Suggested change

	The following sections describe how to configure your application's
	serialization of BSON data:
	The following sections describe how to configure the way your application
	serializes BSON data:

[rustagir]

S: maybe its worth adding a sentence below here that says that the USER enum value was stored as a 1 in MongoDB, but deserialized correctly into the enum value. But can also leave out if its obvious/redundant.