DOCSP-26099: cs is an async iterable

[rustagir]

Pull Request Info

PR Reviewing Guidelines

JIRA - https://jira.mongodb.org/browse/DOCSP-26099
Staging - https://docs-mongodbcom-staging.corp.mongodb.com/node/docsworker-xlarge/DOCSP-26099-cs-iterable/usage-examples/changeStream/

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?

[rustagir]

I'm divided on whether to update the example to reflect this change and use a for-await loop in the code snippet, instead of a listener.

[mongoKart]

just one small suggestion!

[mongoKart]

Looks better. A few more small suggestions

[mongoKart]

I: Next clause refers to a single change

S:

Suggested change

	When you run this code and then make any changes to the ``haikus``
	When you run this code and then make a change to the ``haikus``

[mongoKart]

I: "Once set" is vague

S: "Once the [whatever] is [whatever], generate a change event..."

[mongoKart]

Suggested change

	To generate the change event on the collection, let's use ``insertOne()``
	method to add a new document. Since the ``insertOne()`` may run before the
	To generate the change event on the collection, let's use the ``insertOne()``
	method to add a new document. Since ``insertOne()`` may run before the

[mongoKart]

Suggested change

	We also use ``simulateAsyncPause`` after the insertion of the document
	to provide ample time for the listener function to receive the change
	event and for the listener to complete its execution before
	closing the ``ChangeStream`` instance using the ``close()`` method.
	We also use ``simulateAsyncPause`` after the insertion of the document.
	This provides ample time for the listener function to receive the change
	event and for the listener to complete its execution before
	closing the ``ChangeStream`` instance using the ``close()`` method.

[mongoKart]

S: Put this in a Note admonition to make it stand out

Suggested change

	The timers used in this example are only necessary for this demonstration
	to make sure there is enough time to register listener and have the
	listener process the event before exiting.
	.. note:: You don't need timers to use listener functions.
	The timers in this code example are for demonstration purposes only.

...or something similar.

[rustagir]

this creates two stacked notes, but the second note is repetitive from the previous example. I think I should either shift the content out of the note back to normal text, or delete the repetitive note about connecting to MongoDB/sample data.

[mongoKart]

I'm in favor of deleting the redundant note.

[mongoKart]

lgtm + removing redundant note

[rustagir]

💚 All backports created successfully

Status	Branch	Result
✅	v5.0
✅	v4.14
✅	v4.13
✅	v4.12

Note: Successful backport PRs will be merged automatically after passing CI.

Questions ?

Please refer to the Backport tool documentation