Skip to content

Conversation

ltran-mdb2
Copy link
Collaborator

@ltran-mdb2 ltran-mdb2 commented Sep 12, 2024

DESCRIPTION

Adds a page on the MongoDB Github Copilot Participant and the /query command
Adds a page on AI and Data Usage (Based on the Compass AI and Data Usage page)

STAGING

https://deploy-preview-92--docs-mongodb-vscode.netlify.app/copilot/
https://deploy-preview-92--docs-mongodb-vscode.netlify.app/ai-data-usage/
https://deploy-preview-92--docs-mongodb-vscode.netlify.app/copilot-query/

JIRA

https://jira.mongodb.org/browse/DOCSP-43493

Self-Review Checklist

  • Is this free of any warnings or errors in the RST?
  • Is this free of spelling errors?
  • Is this free of grammatical errors?
  • Is this free of staging / rendering issues?
  • Are all the links working?

External Review Requirements

What's expected of an external reviewer?

Copy link

netlify bot commented Sep 12, 2024

Deploy Preview for docs-mongodb-vscode ready!

Name Link
🔨 Latest commit 318a61a
🔍 Latest deploy log https://app.netlify.com/sites/docs-mongodb-vscode/deploys/66f6d06406a04e000831f714
😎 Deploy Preview https://deploy-preview-92--docs-mongodb-vscode.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
Lighthouse
Lighthouse
1 paths audited
Performance: 30 (🔴 down 17 from production)
Accessibility: 91 (🟢 up 7 from production)
Best Practices: 75 (no change from production)
SEO: 69 (no change from production)
PWA: -
View the detailed breakdown and full score reports

To edit notification comments on pull requests, go to your Netlify site configuration.

Copy link
Collaborator

@mdb-ashley mdb-ashley left a comment

Choose a reason for hiding this comment

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

LGTM, just left a question for your consideration. Thanks, Lauren!

.. code-block:: javascript
:copyable: false

{
Copy link
Collaborator

Choose a reason for hiding this comment

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

[question] Should we use the edu dataset for examples like this?

Copy link
Collaborator Author

@ltran-mdb2 ltran-mdb2 Sep 17, 2024

Choose a reason for hiding this comment

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

I think it makes sense to do so! I changed the example to use the sample Mflix database

---------------------

The MongoDB Github Copilot Participant is powered by `Github Copilot <https://github.com/features/copilot>`__.
This is subject to change in the future.

Choose a reason for hiding this comment

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

I'm not sure if this will ever change since it is an extension for Github Copilot.

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

Removed the line about changing!

---------------------

When you use the MongoDB Github Copilot Participant, the following
information is sent to MongoDB's backend and/or the third party AI

Choose a reason for hiding this comment

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

The 'third party AI provider' here refer distinct to two things:

  1. The LLM API exposed by Copilot itself (we theoretically use the exact same LLM that Copilot uses)
  2. Our docs chatbot API endpoint used by our Docs Chatbot

Choose a reason for hiding this comment

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

Not sure if we need to be that specific, however,

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

@themantissa What do you think?

Choose a reason for hiding this comment

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

It doesn't really fit the header but I tend to like to over-provide than under so it would be good to note we augment the underlying LLM with our own docs chatbot.

|vsce-full| includes a MongoDB Github Copilot Participant to assist in
using `Github Copilot <https://github.com/features/copilot>`__ with your
MongoDB deployments. Through Github Copilot's chat feature, users with
|vsce| can interact with their MongoDB clusters and generate code with

Choose a reason for hiding this comment

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

Let's also include that they can ask questions about their database collection schema, and ask MongoDB documentation questions that the participant will provide an answer to with specific docs URLs as a reference.

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

Done!

When the LLM generates a query, you can open the query in a playground
file or run the query directly in your collection.

Example

Choose a reason for hiding this comment

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

Could we provide an example where we can show that users can iteratively build an aggregation with Copilot? Sent over a view of this example to you over slack!

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

Done! Because adding this example requires more page space, I made the /query section a separate page so that we can add longer examples for each command without resulting in one super long page.

Copy link

@GaurabAryal GaurabAryal left a comment

Choose a reason for hiding this comment

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

LGTM

Copy link

@themantissa themantissa left a comment

Choose a reason for hiding this comment

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

One edit and comment responses. Reach out if any questions. Thanks!

snooty.toml Outdated
cps = ":abbr:`CPS (Cloud Provider Snapshots)`"
cmk = ":abbr:`CMK (customer master key)`"
compass = "MongoDB Compass"
copilot = "MongoDB Github Copilot Participant"

Choose a reason for hiding this comment

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

There is a capital H in GitHub - we should correct throughout.

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

Fixed!

Choose a reason for hiding this comment

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

Thank you!

---------------------

When you use the MongoDB Github Copilot Participant, the following
information is sent to MongoDB's backend and/or the third party AI

Choose a reason for hiding this comment

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

It doesn't really fit the header but I tend to like to over-provide than under so it would be good to note we augment the underlying LLM with our own docs chatbot.


The MongoDB Github Copilot Participant is powered by `Github Copilot <https://github.com/features/copilot>`__.

How Your Data is Used

Choose a reason for hiding this comment

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

I'd like us to make sure to run this answer by Product legal if we haven't yet. This contains what we normally include but because we get so many questions from customers it's just good to be sure we have covered our bases here. We've been primarily working with Rachael McClure - let me know if you need any assistance in getting a check here. cc @GaurabAryal

@ltran-mdb2
Copy link
Collaborator Author

Thanks for your feedback @themantissa ! I added a mention of the docs chatbot and fixed the GitHub spelling error - could you take another look when you get a chance?

Copy link

@themantissa themantissa left a comment

Choose a reason for hiding this comment

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

Thank you for the quick turnaround.

@ltran-mdb2 ltran-mdb2 merged commit a87167b into mongodb:master Sep 27, 2024
4 of 5 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants