Skip to content
Merged
Changes from 5 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
22 changes: 21 additions & 1 deletion source/playgrounds.txt
Original file line number Diff line number Diff line change
Expand Up @@ -78,7 +78,8 @@ Create a New Playground
~~~~~~~~~~~~~~~~~~~~~~~

You can create a new playground from the :guilabel:`Playgrounds`
panel, the |vsce| *Overview* page, or the |vscode| Command Pallette.
panel, the |vsce| *Overview* page, the |vscode| Command Pallette, or
your project file.

.. tabs::

Expand Down Expand Up @@ -121,6 +122,25 @@ panel, the |vsce| *Overview* page, or the |vscode| Command Pallette.

.. include:: /includes/steps/open-new-playground.rst

.. tab:: Your Project File

Choose a reason for hiding this comment

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

@ltran-mdb2 I think this might best for this to live in it's own nav as it is a complimentary feature to "Export to Language". We could call it "Test Application Query" in the nav and make the title "Export and Test Application Query in Playgrounds".

Lastly, on both of them (i.e. Export to Language) - could we call out that these features are currently only available for users who have Github Copilot & MongoDB's Copilot extension enabled?

:tabid: project-file

1. Open a project file.

Choose a reason for hiding this comment

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

Needs to be more specific, something like:
"Open your application project file that has the MongoDB query you want to export"


To open a file in |vscode-short|, click the file name in the

Choose a reason for hiding this comment

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

I think we can omit this part (fairly obvious for users who use the IDE)

file explorer.

#. Highlight the code that you want to open in a playground.

Choose a reason for hiding this comment

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

Here we should be specific about "highlighting the code of the query you want to test"


#. Right-click to select :guilabel:`Export Code to Playground`.

Right-click your selected code to open the options menu.
Click :guilabel:`MongoDB Copilot Participant` >

Choose a reason for hiding this comment

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

In the immediate update coming up we're renaming this to "MongoDB Copilot Extension" instead of "Participant". Let's change it here so we don't have to amend shortly after.

:guilabel:`Export Code to Playground`.

When you click :guilabel:`Export Code to Playground`, |vscode-short|
opens a new playground with your selected code.

Choose a reason for hiding this comment

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

Let's specify that this opens a new MongoDB playground file with your query exported to MongoDB Shell syntax. You can then hit the run button in the top left corner to test this query with the cluster you are currently connected to in your MongoDB extension. You can iterate on your query in the playgrounds until you are happy with your query. Once the query looks good to you, you can export it back to your application code by using the Export to Language feature (link to Export to Language page).

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

I will add the note about exporting to language with the Export to Language PR (since this one will be merged first)


Open a Saved Playground
~~~~~~~~~~~~~~~~~~~~~~~

Expand Down
Loading