@@ -150,19 +150,48 @@ If you have a playground file open in |vscode-short| and do not have
150150an active connection, |vsce| displays
151151:guilabel:`Click here to add connection` at the top of your playground.
152152
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
162155
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
166195
167196.. note::
168197
0 commit comments