DOCSP-41760 Add transactions page

[stephmarie17]

Pull Request Info

PR Reviewing Guidelines

JIRA - https://jira.mongodb.org/browse/DOCSP-41760
Staging - https://preview-mongodbstephmarie17.gatsbyjs.io/kotlin/docsp-41760-addTransactionsPage/fundamentals/transactions/

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?

[mcmorisi]

The copy looks good, just some notes on the code sample!

[mcmorisi]

LGTM with one last suggestion!

[netlify]

✅ Deploy Preview for docs-kotlin ready!

Name	Link
🔨 Latest commit	2d7c437
🔍 Latest deploy log	https://app.netlify.com/sites/docs-kotlin/deploys/66ccdfce01b1460008a686eb
😎 Deploy Preview	https://deploy-preview-167--docs-kotlin.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 site configuration.

[stephmarie17]

Tagging @mongodb/dbx-java for technical review 🙇‍♀️

[jyemin]

Am I correct that this page doesn't exist yet for the Java sync driver? I was looking to compare the two.

[stephmarie17]

Am I correct that this page doesn't exist yet for the Java sync driver? I was looking to compare the two.

@jyemin Correct, we're in the process of adding these pages. There are a few PRs for Java-related transactions pages in progress:

• Java Sync
• Java RS

Then one for Kotin sync will be upcoming. There are some examples of existing Transaction pages for other drivers in the JIRA ticket if that is helpful!

[jyemin]

Everything looks good but wondering whether we should document com.mongodb.kotlin.client.ClientSession#withTransaction here as well, or if that's going in a different PR.

[stephmarie17]

@jyemin thanks for taking a look! I didn't see withTransaction in the API docs so I wasn't sure if that was supported. Is that supported and is there more info someplace in the API docs that I missed?

One other question I have: once this PR is approved and published, to what version of Kotlin Coroutine should we backport the docs update? The docs versions are upcoming, 5.1, 5.0, 4.11, and 4.10.

[jyemin]

I didn't see withTransaction in the API docs so I wasn't sure if that was supported. Is that supported and is there more info someplace in the API docs that I missed?

Oh, I thought this was a Kotlin Sync Driver page. Are you sure we don't need some sort of call to runBlocking anywhere?

One other question I have: once this PR is approved and published, to what version of Kotlin Coroutine should we backport the docs update? The docs versions are upcoming, 5.1, 5.0, 4.11, and 4.10.

It's up to docs team how far all these pages will be backported.

[stephmarie17]

I didn't see withTransaction in the API docs so I wasn't sure if that was supported. Is that supported and is there more info someplace in the API docs that I missed?

Oh, I thought this was a Kotlin Sync Driver page. Are you sure we don't need some sort of call to runBlocking anywhere?

Will be working on the Kotlin Sync page soon! There's a call to runBlocking in the example file (examples/src/test/kotlin/TransactionsTest.kt) but the snippet displayed in the docs starts after that.

[jyemin]

LGTM

[docs-builder-bot]

✨ Staging URL: https://preview-mongodbmongodb.gatsbyjs.io/kotlin/master/

🪵 Logs

• job log: e0c22eefa3a8346be0cbeeed213abe9f358ff030