From cc5486d66e11f346931a76e50ae1c2f7e7802c84 Mon Sep 17 00:00:00 2001
From: Lena <126529524+acuteenvy@users.noreply.github.com>
Date: Tue, 1 Aug 2023 09:21:03 +0200
Subject: [PATCH] mongo*: update pages & add mongosh (#10558)

---
 pages/common/mongo.md   | 21 +++++++++++----------
 pages/common/mongod.md  |  8 ++++++--
 pages/common/mongosh.md | 21 +++++++++++++++++++++
 3 files changed, 38 insertions(+), 12 deletions(-)
 create mode 100644 pages/common/mongosh.md

diff --git a/pages/common/mongo.md b/pages/common/mongo.md
index 9ac28189f5..0d460a52a7 100644
--- a/pages/common/mongo.md
+++ b/pages/common/mongo.md
@@ -1,20 +1,21 @@
 # mongo
 
-> MongoDB interactive shell client.
+> The legacy MongoDB shell. See `mongosh` for the new shell.
+> Note: all connection options can be replaced with one string: `mongodb://user@host:port/db_name?authSource=authdb_name`.
 > More information: <https://docs.mongodb.com/manual/reference/program/mongo>.
 
+- Connect to a local database on the default port (`mongodb://localhost:27017`):
+
+`mongo`
+
 - Connect to a database:
 
-`mongo {{database}}`
+`mongo --host {{host}} --port {{port}} {{db_name}}`
 
-- Connect to a database running on a given host on a given port:
+- Authenticate using the specified username on the specified database (you will be prompted for a password):
 
-`mongo --host {{host}} --port {{port}} {{database}}`
+`mongo --host {{host}} --port {{port}} --username {{username}} --authenticationDatabase {{authdb_name}} {{db_name}}`
 
-- Connect to a database with a given username; user will be prompted for password:
+- Evaluate a JavaScript expression on a database:
 
-`mongo --username {{username}} {{database}} --password`
-
-- Evaluate a JavaScript expression on the database:
-
-`mongo --eval '{{JSON.stringify(db.foo.findOne())}}' {{database}}`
+`mongo --eval '{{JSON.stringify(db.foo.findOne())}}' {{db_name}}`
diff --git a/pages/common/mongod.md b/pages/common/mongod.md
index 4374e06250..1aeb792313 100644
--- a/pages/common/mongod.md
+++ b/pages/common/mongod.md
@@ -3,14 +3,18 @@
 > The MongoDB database server.
 > More information: <https://docs.mongodb.com/manual/reference/program/mongod>.
 
+- Specify the storage directory (default: `/data/db` on Linux and MacOS, `C:\data\db` on Windows):
+
+`mongod --dbpath {{path/to/directory}}`
+
 - Specify a config file:
 
 `mongod --config {{path/to/file}}`
 
-- Specify the port to listen on:
+- Specify the port to listen on (default: 27017):
 
 `mongod --port {{port}}`
 
-- Specify database profiling level. 0 is off, 1 is only slow operations, 2 is all:
+- Specify the database profiling level. 0 is off, 1 is only slow operations, 2 is all (default: 0):
 
 `mongod --profile {{0|1|2}}`
diff --git a/pages/common/mongosh.md b/pages/common/mongosh.md
new file mode 100644
index 0000000000..e3e592b196
--- /dev/null
+++ b/pages/common/mongosh.md
@@ -0,0 +1,21 @@
+# mongosh
+
+> A new shell for MongoDB, replacement for `mongo`.
+> Note: all connection options can be replaced with one string: `mongodb://user@host:port/db_name?authSource=authdb_name`.
+> More information: <https://www.mongodb.com/docs/mongodb-shell>.
+
+- Connect to a local database on the default port (`mongodb://localhost:27017`):
+
+`mongosh`
+
+- Connect to a database:
+
+`mongosh --host {{host}} --port {{port}} {{db_name}}`
+
+- Authenticate using the specified username on the specified database (you will be prompted for a password):
+
+`mongosh --host {{host}} --port {{port}} --username {{username}} --authenticationDatabase {{authdb_name}} {{db_name}}`
+
+- Evaluate a JavaScript expression on a database:
+
+`mongosh --eval '{{JSON.stringify(db.foo.findOne())}}' {{db_name}}`