@@ -150,19 +150,48 @@ If you have a playground file open in |vscode-short| and do not have
150
150
an active connection, |vsce| displays
151
151
:guilabel:`Click here to add connection` at the top of your playground.
152
152
153
- .. figure:: /images/vsce-playground-add-connection-btn.png
154
- :figwidth: 700px
155
- :alt: Link to add connection from playground
156
-
157
- 1. Click this link to open the connection string dialog.
158
-
159
- #. Enter the
160
- :manual:`connection string </reference/connection-string/>` for the
161
- deployment you want to run this playground against.
153
+ .. procedure::
154
+ :style: normal
162
155
163
- #. Press :guilabel:`Enter`.
164
-
165
- #. Run your playground.
156
+ .. step:: Select :guilabel:`Click here to add connection`
157
+
158
+ After you click :guilabel:`Click here to add connection`, |vsce| displays
159
+ the connection string drop-down menu.
160
+
161
+ .. figure:: /images/vsce-playground-add-connection-btn.png
162
+ :figwidth: 700px
163
+ :alt: Link to add connection from playground
164
+
165
+ .. step:: Click :guilabel:`Add new connection`
166
+
167
+ In the connection string drop-down menu, select
168
+ :guilabel:`Add new connection` to enter a new connection string. If you
169
+ have previously connected to the playground with another deployment, the
170
+ connection string will appear as an option under the drop-down menu.
171
+
172
+ .. step:: Enter your connection string
173
+
174
+ Enter the :manual:`connection string </reference/connection-string/>` to
175
+ connect to your deployment.
176
+
177
+ .. note::
178
+
179
+ If the connection string specifies a database the playground runs
180
+ against that database by default. To switch databases,
181
+ call ``use('<database_name>')``.
182
+
183
+ If you are connected to a default database, the playground
184
+ autocompletes only for collection names available on that
185
+ database.
186
+
187
+ .. step:: Press Enter
188
+
189
+ After you enter your connection string, a `CodeLens <https://code.visualstudio.com/blogs/2017/02/12/code-lens-roundup>`_
190
+ replaces the :guilabel:`Click here to add connection` link. The
191
+ CodeLens includes information on the connected deployment and, if
192
+ applicable, the current database.
193
+
194
+ .. step:: Run your playground
166
195
167
196
.. note::
168
197
0 commit comments