Integrate/MongoDB: Implement suggestions by CodeRabbit

Author: amotl

docs/integrate/mongodb/cloud.md

@@ -4,45 +4,44 @@ The procedure for importing data from [MongoDB Atlas] into [CrateDB Cloud] is
 similar, with a few small adjustments.
 
 First, helpful aliases again:
-:::{code} shell
-alias ctk="docker run --rm -it ghcr.io/crate/cratedb-toolkit ctk"
+```shell
 alias crash="docker run --rm -it ghcr.io/crate-workbench/cratedb-toolkit crash"
-:::
+alias ctk="docker run --rm -i ghcr.io/crate/cratedb-toolkit ctk"
+```
 
 You will need your credentials for both CrateDB and MongoDB. 
 These are, with examples:
 
 **CrateDB Cloud**
-* Host: ```gray-wicket.aks1.westeurope.azure.cratedb.net```
-* Username: ```admin```
-* Password: ```-9..nn```
+* Host: `<CRATEDB_CLOUD_HOST>`
+* Username: `<CRATEDB_USER>`
+* Password: `<CRATEDB_PASSWORD>`
 
 **MongoDB Atlas**
-  * Host: ```cluster0.nttj7.mongodb.net```
-  * User: ```admin```
-  * Password: ```a1..d1```
+  * Host: `<MONGODB_ATLAS_HOST>`
+  * User: `<MONGODB_USER>`
+  * Password: `<MONGODB_PASSWORD>`
 
 For CrateDB, the credentials are displayed at time of cluster creation.
 For MongoDB, they can be found in the [cloud platform] itself.
 
 Now, same as before, import data from MongoDB database/collection into 
 CrateDB schema/table.
-:::{code} shell
+```shell
 ctk load table \
   "mongodb+srv://admin:[email protected]/testdrive/demo" \
   --cluster-url='crate://admin:[email protected]:4200/testdrive/demo?ssl=true'
-:::
+```
 
-::: {note}
-Note the **necessary** `ssl=true` query parameter at the end of both database connection URLs
-when working on Cloud-to-Cloud transfers.
+:::{note}
+CrateDB Cloud requires `ssl=true` in the cluster URL. For MongoDB Atlas SRV URIs
+(`mongodb+srv://`), TLS is implied and no extra parameter is needed.
 :::
 
 Verify that relevant data has been transferred to CrateDB.
-:::{code} shell
+```shell
 crash --hosts 'https://admin:[email protected]:4200' --command 'SELECT * FROM testdrive.demo;'
-:::
-
+```
 
 
 [cloud platform]: https://cloud.mongodb.com

docs/integrate/mongodb/index.md

@@ -104,9 +104,8 @@ model
 :::
 
 :::{note}
-The MongoDB I/O subsystem is based on the [migr8] migration utility package. Please also
-check its documentation to learn about more of its capabilities, supporting
-you when working with MongoDB.
+The MongoDB I/O subsystem is based on the [migr8] migration utility package. Consult its
+documentation for advanced capabilities when working with MongoDB.
 :::
 
 

docs/integrate/mongodb/model.md

@@ -13,14 +13,17 @@ data in schemas and tables.
 - A **field** in MongoDB is similar to a column in a CrateDB table. In both
   systems, fields (or columns) define the attributes for the records
   (or rows/documents).
-- A **primary key** in MongoDB is typically the _id field, which uniquely 
+- A **primary key** in MongoDB is typically the `_id` field, which uniquely
   identifies a document within a collection. In CrateDB, a primary key 
   uniquely identifies a row in a table.
 - An **index** in MongoDB is similar to an index in CrateDB. Both are used to
   improve query performance by providing a fast lookup for fields (or columns)
   within documents (or rows).
 
+
+:::{seealso}
 -- [Databases and Collections]
+:::
 
 
 [Databases and Collections]: https://www.mongodb.com/docs/manual/core/databases-and-collections/

docs/integrate/mongodb/tutorial.md

@@ -38,7 +38,7 @@ programs.
 ::::{tab-set}
 
 :::{tab-item} Linux and macOS
-To make the settings persistent, add them to your Shell profile (`~/.profile`).
+To make the settings persistent, add them to your shell profile (e.g., `~/.profile` or `~/.zshrc`).
 ```shell
 alias crash="docker run --rm -it --network=cratedb-demo ghcr.io/crate/cratedb-toolkit crash"
 alias ctk="docker run --rm -i --network=cratedb-demo ghcr.io/crate/cratedb-toolkit ctk"
@@ -65,7 +65,7 @@ doskey mongosh=docker run --rm -i --network=cratedb-demo docker.io/mongo mongosh
 
 ## Usage
 
-Insert record into MongoDB collection; you can also do it twice or more.
+Insert a record into a MongoDB collection; you can repeat this step as needed.
 ```shell
 mongosh --host mongodb --eval 'db.testdrive.insert({"temperature": 42.84, "humidity": 83.1})'
 ```
@@ -82,17 +82,13 @@ Inspect data stored in CrateDB.
 crash --hosts cratedb -c "SELECT * FROM doc.testdrive"
 ```
 
-::::{todo}
 
-Import data to MongoDB:
+::::{tip}
+To bulk import example data into MongoDB:
 :::{code} shell
 mongoimport --db testdrive --collection demo --file demodata.json --jsonArray
 :::
-
-:::{note}
-`mongoimport` is part of the [MongoDB Database tools].
-:::
-
+Note: `mongoimport` is part of the [MongoDB Database tools].
 ::::