Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 5 additions & 7 deletions source/commands.txt
Original file line number Diff line number Diff line change
@@ -1,8 +1,8 @@
.. _vsce-commands:

=====================
|vsce-short| Commands
=====================
=======================
|vscode-short| Commands
=======================

.. default-domain:: mongodb

Expand Down Expand Up @@ -76,10 +76,8 @@ To learn more about connecting to a deployment, see :ref:`vsce-connect`.
- Select and remove a connection from your list of connections
in |vsce|.

.. note::

Removing your current active connection also closes that
connection.
Removing your current active connection also closes that
connection.

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I can't comment on the applicable lines, but on this file and on settings.txt, build errors are being caused by the |vsce-short| substitution. Can you check to make sure this variable exists in snooty.toml? If not, replace the variable with |vsce| !

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@ajhuh-mdb Tried to fix the build errors seems like the new command is 'vscode-short'. Hopefully that works!

Shell Commands
--------------
Expand Down
24 changes: 10 additions & 14 deletions source/includes/admonitions/warn-configure-path.rst
Original file line number Diff line number Diff line change
@@ -1,19 +1,15 @@
.. important::
To launch your selected MongoDB shell, you must:

To launch your selected MongoDB shell, you must:
- Install the shell you want to use, and

- Install the shell you want to use, and
- Configure your machine's ``PATH`` environment variable to include
the filepath to your shell binary.

- Configure your machine's ``PATH`` environment variable to include
the filepath to your shell binary.
If you install a new version of your MongoDB shell, you will need to

Check failure on line 8 in source/includes/admonitions/warn-configure-path.rst

View workflow job for this annotation

GitHub Actions / TDBX Vale rules

[vale] reported by reviewdog 🐶 [MongoDB.ConciseTerms] 'must' is preferred over 'will need to'. Raw Output: {"message": "[MongoDB.ConciseTerms] 'must' is preferred over 'will need to'.", "location": {"path": "source/includes/admonitions/warn-configure-path.rst", "range": {"start": {"line": 8, "column": 57}}}, "severity": "ERROR"}
update your ``PATH`` variable to reference the new version.

If you install a new version of your MongoDB shell, you will need to
update your ``PATH`` variable to reference the new version.
- To install the legacy :binary:`mongo <mongo>`
shell, see :manual:`The mongo Shell </mongo>`.

.. seealso::

- To install the legacy :binary:`mongo <mongo>`
shell, see :manual:`The mongo Shell </mongo>`.

- To install the ``mongosh`` shell and for instructions on
configuring your ``PATH`` variable, see :mongosh:`Install the MongoDB Shell </install>`.
- To install the ``mongosh`` shell and for instructions on
configuring your ``PATH`` variable, see :mongosh:`Install the MongoDB Shell </install>`.
Original file line number Diff line number Diff line change
Expand Up @@ -157,33 +157,30 @@ content: |
specify the :guilabel:`Hostname`. You do not need to
specify a port.

.. note::

You can only use SRV connection strings to connect to
deployments running MongoDB 3.6 and later.


SRV connection strings have a prefix of
``mongodb+srv:``. If you are using an SRV connection
string, you do not need to include ``mongodb+srv`` in
your :guilabel:`Hostname`.

.. example::
For example:

If the following is your SRV connection string for
your MongoDB deployment:
If the following is your SRV connection string for
your MongoDB deployment:

.. code-block:: shell
:copyable: false
.. code-block:: shell
:copyable: false

mongodb+srv://<username>:<password>@gettingstarted-7q2cs.mongodb.net/test
mongodb+srv://<username>:<password>@gettingstarted-7q2cs.mongodb.net/test

Then, in |vsce|, you would specify your
:guilabel:`Hostname` as:
Then, in |vsce|, you would specify your
:guilabel:`Hostname` as:

.. code-block:: shell
:copyable: false
.. code-block:: shell
:copyable: false

gettingstarted-7q2cs.mongodb.net
gettingstarted-7q2cs.mongodb.net

* - :guilabel:`Authentication`
- Authentication to use if the deployment requires
Expand Down Expand Up @@ -258,14 +255,13 @@ content: |
provide the :guilabel:`Username` to authenticate
the user.

.. note::

If you are using
:atlas:`Atlas-managed certificates </security-add-mongodb-users/#select-an-authentication-method>`
, your username must be prefaced by "CN="
per `RFC 2253 <https://tools.ietf.org/html/rfc2253>`__.
For example, the username "X509User" must be
provided as "CN=X509User".
If you are using
:atlas:`Atlas-managed certificates </security-add-mongodb-users/#select-an-authentication-method>`
, your username must be prefaced by "CN="
per `RFC 2253 <https://tools.ietf.org/html/rfc2253>`__.
For example, the username "X509User" must be
provided as "CN=X509User".

- id: ldap
name: LDAP
Expand Down
6 changes: 3 additions & 3 deletions source/settings.txt
Original file line number Diff line number Diff line change
@@ -1,8 +1,8 @@
.. _vsce-settings:

=====================
|vsce-short| Settings
=====================
=======================
|vscode-short| Settings
=======================

.. default-domain:: mongodb

Expand Down
Loading