Docsp 30927 work with bson options

[nickldp]

Pull Request Info

PR Reviewing Guidelines

JIRA - https://jira.mongodb.org/browse/DOCSP-30927
Staging

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?

[mongoKart]

Nice job! A few small changes

[mongoKart]

Issue: I'm not sure what "any level" refers to. How many are there?

Suggestion: Can we be more specific about these levels?

[mongoKart]

I: Two points from the Style Guide here: Avoid passive voice and Don't use "using" alone

S:

Suggested change

	The following example demonstrates how the ``BSONOptions`` is set using
	the ``Movies`` collection as an example.
	The following example demonstrates how to set ``BSONOptions`` for
	the ``Movies`` collection:

[mongoKart]

I: In our other docs, we keep collection names lowercase (e.g. here)

S:

Suggested change

	The following example demonstrates how the ``BSONOptions`` is set using
	the ``Movies`` collection as an example.
	The following example demonstrates how the ``BSONOptions`` is set using
	the ``movies`` collection as an example.

[mongoKart]

I: This sentence can probably be shorter and a little clearer

S:

Suggested change

	To learn more about the options and usage of ``BSONOptions``, visit the `API Documentation
	<https://pkg.go.dev/go.mongodb.org/mongo-driver/mongo#example-Connect-BSONOptions>`_
	for more information.
	To learn more about ``BSONOptions``, see the `API Documentation
	<https://pkg.go.dev/go.mongodb.org/mongo-driver/mongo#example-Connect-BSONOptions>`__.

[mongoKart]

S: Put this sentence in a Tip box, since it's more supplementary than a natural conclusion to this section

[mongoKart]

I: I think these lines should be dedented back to the beginning...

Suggested change

	coll := client.Database("sample_mflix").Collection("movies",
	bsonOpts)
	coll := client.Database("sample_mflix").Collection("movies",
	bsonOpts)

[mongoKart]

S: We almost always use source constants (in snooty.toml) to represent API links, making it easier and less error-prone. I would try using a source constant here.

[mongoKart]

S: I'm not a Go expert, but structuring the code like the following seems more readable:

Suggested change

	bsonOpts := &options.BSONOptions{
	UseJSONStructTags: true,
	}
	coll := client.Database("sample_mflix").Collection("movies",
	bsonOpts)
	bsonOpts := &options.BSONOptions {
	UseJSONStructTags: true
	}
	coll := client.Database("sample_mflix")
	.Collection("movies", bsonOpts)

What do you think?

[nickldp]

Agree with everything, but comma on line 227 is needed

[mongoKart]

LGTM + 1 suggestion. Great job addressing the feedback!